diff --git a/doc/source/1702.rst b/doc/source/1702.rst
index 19d7b106..972936a1 100644
--- a/doc/source/1702.rst
+++ b/doc/source/1702.rst
@@ -148,6 +148,8 @@ deployment of the Rados Gateway using Apache and mod_fastcgi; existing deploymen
 will be reconfigured on upgrade to use the embedded webserver support provided
 by the radosgw binaries.
 
+The `use-embedded-webserver` option has been removed from this charm and should be
+dropped from any bundles.
 
 ceph pool permissions restrictions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~