diff --git a/docs/e2ee.md b/docs/e2ee.md
index fe4931f56f..f7a32dfcc0 100644
--- a/docs/e2ee.md
+++ b/docs/e2ee.md
@@ -9,8 +9,14 @@ Set the following on your homeserver's
 `/.well-known/matrix/client` config:
 ```json
 {
-  "im.vector.riot.e2ee": {
+  "im.vector.e2ee": {
     "default": false
   }
 }
 ```
+
+# Compatibility
+
+The settings above were first proposed under a `im.vector.riot.e2ee` key, which
+is now deprecated. Element will check for either key, preferring
+`im.vector.e2ee` if both exist.