From 13be5dc46d459d466d6ef97166adba76b94ced8a Mon Sep 17 00:00:00 2001 From: Federico Coppede Date: Thu, 15 Jan 2026 12:07:23 -0300 Subject: [PATCH] docs: organization context clarification (#11368) Added some clarification based on user's feedback. --- docs/docs/guides/manage/console/organizations-overview.mdx | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/docs/guides/manage/console/organizations-overview.mdx b/docs/docs/guides/manage/console/organizations-overview.mdx index cb54f2673..81a01b3ee 100644 --- a/docs/docs/guides/manage/console/organizations-overview.mdx +++ b/docs/docs/guides/manage/console/organizations-overview.mdx @@ -149,7 +149,12 @@ To apply a custom design (e.g., for a specific B2B customer): 3. Ensure the **Login Behavior** on your **Project** is configured to allow organization-specific branding. Read more about project branding [here](./projects-overview#branding). ### Triggering Organization Context +When a user begins the login process, ZITADEL automatically determines the user's organization based on their entered login name and redirects them to the appropriate organization context. Users cannot select their organization manually. + By default, the ZITADEL Login uses the instance default settings. To trigger the specific settings (and branding) of an organization, you must provide the organization scope in your authentication request: ```bash -urn:zitadel:iam:org:id:{id} \ No newline at end of file +urn:zitadel:iam:org:id:{id} +``` + +This value is a [reserved scope](/docs/apis/openidoauth/scopes#reserved-scopes) within ZITADEL. \ No newline at end of file