From a704d3a987ebe1f315b3b00e1bd72d9dd654aa01 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 7 Aug 2026 04:49:08 +0000
Subject: [PATCH 1/3] docs: document multiple JWT login URLs
---
deploy/authentication-setup.mdx | 19 +++++++++++++++++++
es/deploy/authentication-setup.mdx | 21 +++++++++++++++++++++
fr/deploy/authentication-setup.mdx | 21 +++++++++++++++++++++
zh/deploy/authentication-setup.mdx | 21 +++++++++++++++++++++
4 files changed, 82 insertions(+)
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
index 94f1164092..e7dbdf2246 100644
--- a/deploy/authentication-setup.mdx
+++ b/deploy/authentication-setup.mdx
@@ -224,6 +224,25 @@ You host your documentation at `docs.foo.com` and you have an existing OAuth ser
+### Offer multiple login URLs
+
+If your organization has more than one identity provider or region-specific login flow, you can configure between 2 and 10 named login URLs for your JWT-authenticated site. When more than one URL is set, unauthenticated visitors see a login selection screen with your site's branding, and each option redirects to the URL you configured.
+
+To configure multiple login URLs, provide a list of `{ name, url }` pairs when you update your JWT authentication settings. Each name is displayed to users on the selection screen and must be 1 to 100 characters. Each URL must be a valid URL. With a single login URL, visitors continue to redirect directly to that URL as before.
+
+```json
+{
+ "type": "jwt",
+ "loginUrl": "https://global.example.com/login",
+ "loginUrls": [
+ { "name": "Global", "url": "https://global.example.com/login" },
+ { "name": "EU", "url": "https://eu.example.com/login" }
+ ]
+}
+```
+
+Multiple login URLs apply to site-wide JWT authentication only. JWT [personalization](/create/personalization) accepts a single `loginUrl`.
+
### JWT example
You host your documentation at `docs.foo.com` with an existing authentication system at `foo.com`. You want to extend your login flow to grant access to the docs while keeping your docs separate from your dashboard (or you don't have a dashboard).
diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
index eaa7e6f123..7666fa1df4 100644
--- a/es/deploy/authentication-setup.mdx
+++ b/es/deploy/authentication-setup.mdx
@@ -265,6 +265,27 @@ Usa esta comparación para elegir el método que se adapte a tu caso de uso. Con
+
+ ### Ofrecer varias URL de inicio de sesión
+
+
+ Si tu organización tiene más de un proveedor de identidad o un flujo de inicio de sesión específico por región, puedes configurar entre 2 y 10 URL de inicio de sesión con nombre para tu sitio con autenticación JWT. Cuando se configura más de una URL, los visitantes no autenticados ven una pantalla de selección de inicio de sesión con la marca de tu sitio, y cada opción redirige a la URL que configuraste.
+
+ Para configurar varias URL de inicio de sesión, proporciona una lista de pares `{ name, url }` al actualizar la configuración de autenticación JWT. Cada nombre se muestra a los usuarios en la pantalla de selección y debe tener entre 1 y 100 caracteres. Cada URL debe ser una URL válida. Con una sola URL de inicio de sesión, los visitantes siguen siendo redirigidos directamente a esa URL como antes.
+
+ ```json
+ {
+ "type": "jwt",
+ "loginUrl": "https://global.example.com/login",
+ "loginUrls": [
+ { "name": "Global", "url": "https://global.example.com/login" },
+ { "name": "EU", "url": "https://eu.example.com/login" }
+ ]
+ }
+ ```
+
+ Varias URL de inicio de sesión solo se aplican a la autenticación JWT de todo el sitio. La [personalización](/es/create/personalization) JWT acepta un único `loginUrl`.
+
### Ejemplo de JWT
diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
index f88f5a1978..5116d1ba93 100644
--- a/fr/deploy/authentication-setup.mdx
+++ b/fr/deploy/authentication-setup.mdx
@@ -265,6 +265,27 @@ Utilisez ce comparatif pour choisir la méthode adaptée à votre cas d'usage. C
+
+ ### Proposer plusieurs URL de connexion
+
+
+ Si votre organisation dispose de plusieurs fournisseurs d’identité ou de flux de connexion spécifiques à une région, vous pouvez configurer entre 2 et 10 URL de connexion nommées pour votre site authentifié par JWT. Lorsque plusieurs URL sont configurées, les visiteurs non authentifiés voient un écran de sélection de connexion aux couleurs de votre site, et chaque option redirige vers l’URL que vous avez configurée.
+
+ Pour configurer plusieurs URL de connexion, fournissez une liste de paires `{ name, url }` lors de la mise à jour de vos paramètres d’authentification JWT. Chaque nom est affiché aux utilisateurs sur l’écran de sélection et doit contenir de 1 à 100 caractères. Chaque URL doit être une URL valide. Avec une seule URL de connexion, les visiteurs continuent d’être redirigés directement vers cette URL comme auparavant.
+
+ ```json
+ {
+ "type": "jwt",
+ "loginUrl": "https://global.example.com/login",
+ "loginUrls": [
+ { "name": "Global", "url": "https://global.example.com/login" },
+ { "name": "EU", "url": "https://eu.example.com/login" }
+ ]
+ }
+ ```
+
+ Plusieurs URL de connexion s’appliquent uniquement à l’authentification JWT à l’échelle du site. La [personnalisation](/fr/create/personalization) JWT accepte une seule `loginUrl`.
+
### Exemple JWT
diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx
index d79ec85404..5d31df1fd6 100644
--- a/zh/deploy/authentication-setup.mdx
+++ b/zh/deploy/authentication-setup.mdx
@@ -265,6 +265,27 @@ keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password', 'private']
+
+ ### 提供多个登录 URL
+
+
+ 如果你的组织有多个身份提供商或按地区区分的登录流程，可以为使用 JWT 认证的站点配置 2 到 10 个具名登录 URL。当配置了多个 URL 时，未认证的访客会看到一个使用你站点品牌样式的登录选择页面，每个选项都会重定向到你所配置的 URL。
+
+ 要配置多个登录 URL，请在更新 JWT 认证设置时提供一个 `{ name, url }` 键值对列表。每个 `name` 会显示在选择页面上，长度必须在 1 到 100 个字符之间。每个 `url` 必须是有效的 URL。当只配置一个登录 URL 时，访客仍会像以前一样直接重定向到该 URL。
+
+ ```json
+ {
+ "type": "jwt",
+ "loginUrl": "https://global.example.com/login",
+ "loginUrls": [
+ { "name": "Global", "url": "https://global.example.com/login" },
+ { "name": "EU", "url": "https://eu.example.com/login" }
+ ]
+ }
+ ```
+
+ 多个登录 URL 仅适用于站点范围的 JWT 认证。JWT [个性化](/zh/create/personalization) 只接受单个 `loginUrl`。
+
### JWT 示例
From 0ccc6dccd96bbd3a30ace5e103616c5775d94679 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 7 Aug 2026 11:15:59 -0700
Subject: [PATCH 2/3] Update deploy/authentication-setup.mdx
---
deploy/authentication-setup.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
index e7dbdf2246..17d68928f8 100644
--- a/deploy/authentication-setup.mdx
+++ b/deploy/authentication-setup.mdx
@@ -241,7 +241,7 @@ To configure multiple login URLs, provide a list of `{ name, url }` pairs when y
}
```
-Multiple login URLs apply to site-wide JWT authentication only. JWT [personalization](/create/personalization) accepts a single `loginUrl`.
+Multiple login URLs only apply to site-wide JWT authentication. JWT [personalization](/create/personalization) accepts a single `loginUrl`.
### JWT example
From 479d3ea9d8a97ed137f026a89e76fd7381050684 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 7 Aug 2026 11:16:06 -0700
Subject: [PATCH 3/3] Update deploy/authentication-setup.mdx
---
deploy/authentication-setup.mdx | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
index 17d68928f8..5512983faf 100644
--- a/deploy/authentication-setup.mdx
+++ b/deploy/authentication-setup.mdx
@@ -226,9 +226,11 @@ You host your documentation at `docs.foo.com` and you have an existing OAuth ser
### Offer multiple login URLs
-If your organization has more than one identity provider or region-specific login flow, you can configure between 2 and 10 named login URLs for your JWT-authenticated site. When more than one URL is set, unauthenticated visitors see a login selection screen with your site's branding, and each option redirects to the URL you configured.
+If your organization has more than one identity provider or region-specific login flows, configure multiple named login URLs for your JWT-authenticated site. You can configure between 1 and 10 login URLs.
-To configure multiple login URLs, provide a list of `{ name, url }` pairs when you update your JWT authentication settings. Each name is displayed to users on the selection screen and must be 1 to 100 characters. Each URL must be a valid URL. With a single login URL, visitors continue to redirect directly to that URL as before.
+When you set more than one URL, unauthenticated visitors see a login selection screen with your site's branding, and each option redirects to your configured URL.
+
+To configure multiple login URLs, provide a list of `{ name, url }` pairs when you update your JWT authentication settings. Names must be between 1 and 100 characters. URLs must be valid.
```json
{