From e4bf321e65499dc86eb94b54eb85e2be6340815b Mon Sep 17 00:00:00 2001
From: Kerry <kerrya@element.io>
Date: Tue, 27 Jun 2023 15:34:58 +1200
Subject: [PATCH] document io.element.e2ee.force_disable (#25662)

---
 docs/e2ee.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/e2ee.md b/docs/e2ee.md
index 534bc4d32e..d0d62ac092 100644
--- a/docs/e2ee.md
+++ b/docs/e2ee.md
@@ -16,6 +16,28 @@ Set the following on your homeserver's
 }
 ```
 
+## Disabling encryption
+
+Set the following on your homeserver's
+`/.well-known/matrix/client` config:
+
+```json
+{
+    "io.element.e2ee": {
+        "force_disable": true
+    }
+}
+```
+
+When `force_disable` is true:
+
+-   all rooms will be created with encryption disabled, and it will not be possible to enable
+    encryption from room settings.
+-   any `io.element.e2ee.default` value will be disregarded.
+
+Note: If the server is configured to forcibly enable encryption for some or all rooms,
+this behaviour will be overriden.
+
 # Secure backup
 
 By default, Element strongly encourages (but does not require) users to set up