From 34e6a792d2f430d5f6da5be20a1147e7449a49eb Mon Sep 17 00:00:00 2001 From: Federico Coppede Date: Mon, 16 Mar 2026 13:12:10 -0300 Subject: [PATCH] docs: text customization on Login V2 (#11849) 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 <175728472+Copilot@users.noreply.github.com> --- apps/docs/content/guides/integrate/login/hosted-login.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/apps/docs/content/guides/integrate/login/hosted-login.mdx b/apps/docs/content/guides/integrate/login/hosted-login.mdx index b87b4e62e..cd41b659b 100644 --- a/apps/docs/content/guides/integrate/login/hosted-login.mdx +++ b/apps/docs/content/guides/integrate/login/hosted-login.mdx @@ -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. + +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. + + ### Fast account switching The hosted login page remembers users who have previously authenticated.