From 242d2c52096566fe99dc9fede8d5592d915efbdb Mon Sep 17 00:00:00 2001 From: David Langley Date: Thu, 30 Jul 2026 12:34:43 +0100 Subject: [PATCH] Clarify docs for login-time autodiscovery (#34385) * Clarify docs for login-time autodiscovery * Update docs/config.md Co-authored-by: R Midhun Suresh --------- Co-authored-by: R Midhun Suresh --- docs/config.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/config.md b/docs/config.md index 7b83e649d6..cbeae705af 100644 --- a/docs/config.md +++ b/docs/config.md @@ -62,6 +62,9 @@ information. endpoints (for example, polling for client configuration after login). Set it to `false` to stop Element making these requests, so it only contacts the homeserver base URL; the `well_known` object returned inline in the `/login` response is unaffected. Defaults to `true`. + This option covers those runtime requests only; login-time `.well-known` autodiscovery is separate. Setting + `default_server_config` with `disable_custom_urls: true` fixes the homeserver and removes the server picker, covering + the startup lookup and server selection. It also doesn't cover the legacy password login form (not shown for delegated authentication/OIDC) which performs its own `.well-known` lookup when a full Matrix ID is entered. ## Labs flags