diff --git a/docs/jitsi-dev.md b/docs/jitsi-dev.md
index b56b2019..093fd79b 100644
--- a/docs/jitsi-dev.md
+++ b/docs/jitsi-dev.md
@@ -78,6 +78,9 @@ The Jitsi widget created by Riot uses a local `jitsi.html` wrapper (or one hoste
 `url`. The wrapper has some basic functionality for talking to Riot to ensure the
 required `postMessage` calls are fulfilled.
 
+**Note**: Per [jitsi.md](./jitsi.md) the `preferredDomain` can also come from the server's
+client .well-known data. 
+
 ## The Jitsi wrapper in Riot
 
 Whenever Riot sees a Jitsi widget, it ditches the `url` and instead replaces it with
@@ -92,3 +95,6 @@ call.
 Critically, when the widget URL is reconstructed it does *not* take into account the
 config.json's `preferredDomain` for Jitsi. If it did this, users would end up on different
 conference servers and therefore different calls entirely. 
+
+**Note**: Per [jitsi.md](./jitsi.md) the `preferredDomain` can also come from the server's
+client .well-known data.
diff --git a/docs/jitsi.md b/docs/jitsi.md
index d3631ee8..1d2c5536 100644
--- a/docs/jitsi.md
+++ b/docs/jitsi.md
@@ -39,6 +39,16 @@ should start a new conference on your Jitsi server.
 **Note**: The widget URL will point to a `jitsi.html` page hosted by Riot. The Jitsi
 domain will appear later in the URL as a configuration parameter.
 
+**Hint**: If you want everyone on your homeserver to use the same Jitsi server by
+default, set the following on your homeserver's `/.well-known/matrix/client` config:
+```json
+{
+  "im.vector.riot.jitsi": {
+    "preferredDomain": "your.jitsi.example.org"
+  }
+}
+```
+
 ## Mobile app support
 
 Currently the Riot mobile apps do not support custom Jitsi servers and will instead