docs: update knowledge gap from thread 1512031509387673610 (#12328)

Automatically generated PR targeting 1 files.

**Thread ID:** 1512031509387673610
**Action:** UPDATE

**AI Summary:**
> The documentation lacks clear explanation of how the 'Use new login
UI' checkbox and 'Custom base URL for the new Login UI' field work
together, including step-by-step configuration and troubleshooting
guidance.

---------

Co-authored-by: zitadel-knowledge-bot[bot] <296006658+zitadel-knowledge-bot[bot]@users.noreply.github.com>
Co-authored-by: fcoppede <[email protected]>
This commit is contained in:
zitadel-knowledge-bot[bot]
2026-06-24 15:32:38 +00:00
committed by GitHub
co-authored by zitadel-knowledge-bot[bot] <296006658+zitadel-knowledge-bot[bot]@users.noreply.github.com> fcoppede
parent 2397247925
commit 9ccafca12b
8 changed files with 41 additions and 10 deletions
@@ -94,7 +94,7 @@ An organization can have multiple domain names, but only one is configured as th
* Which login name is displayed to the user in the UI.
* What information is asserted in `access_tokens` (specifically the `preferred_username` claim).
<Callout type="caution">
<Callout type="warn">
Setting an Organization Domain affects users.
If a user `coyote` exists in the global organization with the login name `[email protected]`, and you subsequently verify `acme.ch` for a specific organization, the global user's login name will be replaced with `coyote@{randomvalue.tld}`. ZITADEL will notify users affected by this change.
</Callout>
@@ -126,7 +126,7 @@ You can disable domain verification requirements in the [default settings](/guid
5. Once verified, click **Verify**.
6. (Optional) Click **Set as primary** to make this the default domain for user login names.
<Callout type="caution">
<Callout type="warn">
Do not delete the DNS verification record after success. ZITADEL re-checks domain ownership periodically.
</Callout>