andwati/zitadel
1
0
Fork 0
mirror of https://github.com/andwati/zitadel.git synced 2026-10-18 05:52:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: text customization on Login V2 (#11849)

Browse Source 
This PR updates the "Hosted Login UI" documentation to clarify how text
customization works for the new Hosted Login V2.

**Changes:**

1. Adds a warning callout to the "Customization options" section.
2. Clarifies that Login V2 interface texts currently cannot be modified
via the ZITADEL Console UI.
3. Provides the required workaround, directing users to use the Settings
V2 API to patch translation keys using the en.json locale file as a
reference.

---------

Co-authored-by: Copilot Autofix powered by AI <[email protected]>
This commit is contained in:
Federico Coppede
2026-03-16 17:12:10 +01:00
committed by GitHub
co-authored by Copilot Autofix powered by AI
parent 500821ce0c
commit 34e6a792d2
1 changed files with 6 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/content/guides/integrate/login/hosted-login.mdx
+6
View File
@@ -81,6 +81,12 @@ The login page can be changed by customizing different branding aspects and you
By default, the displayed branding is defined [based on the user's domain](/guides/solution-scenarios/domain-discovery). In case you want to show the branding of a specific organization by default, you need to either pass an Organization Domain scope (`urn:zitadel:iam:org:domain:primary:{domainname}`) with the authorization request, or define the behavior on your Project's settings.
</Callout>
<Callout type="warning" title="Customizing texts in Hosted Login V2">
Currently, interface texts for the new Hosted Login V2 cannot be customized directly through the Management Console.
To update translations in Login V2, you must use the [Settings V2 API](/apis/resources/settings_service_v2/settings-service-set-hosted-login-translation). You can reference the default keys in the [`en.json` locale file](https://github.com/zitadel/zitadel/blob/main/apps/login/locales/en.json) from the ZITADEL repository. You can send a payload that includes only the keys you want to override; Login V2 will automatically merge your keys with the defaults and handle any fallbacks.
</Callout>
### Fast account switching
The hosted login page remembers users who have previously authenticated.