mintlify · ethanpalm · Jul 7, 2026 · Jul 7, 2026 · Jul 7, 2026 · Jul 7, 2026
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
@@ -18,6 +18,17 @@ You can configure full authentication for all pages or partial authentication wh
 
 Authentication is only available for sites hosted on a custom domain or Mintlify subdomain. For example, `docs.example.com` or `example.mintlify.site`. Authentication is **not supported** for sites with a [custom subpath](/deploy/docs-subpath). For example, `example.com/docs`.
 
+## Choose an authentication method
+
+Use this comparison to pick the method that fits your use case. See [Feature availability](#feature-availability) for how each method interacts with other Mintlify features.
+
+| Method | Best for | Plan | Group-based access | API playground pre-fill | Personalization |
+| :--- | :--- | :--- | :---: | :---: | :---: |
+| Password | Simple shared access with no per-user tracking | Pro or Enterprise | No | No | No |
+| Private authentication | Internal site for members of your Mintlify organization | All plans | No | No | No |
+| OAuth 2.0 | Existing identity provider or SSO with per-user sessions | Enterprise | Yes | Yes | Yes |
+| JWT | Custom auth backend or embedded content behind your own login | Enterprise | Yes | Yes | Yes |
+
 ## Configure authentication
 
 <Tabs>

diff --git a/deploy/export.mdx b/deploy/export.mdx
@@ -45,6 +45,14 @@
   The export only includes pages listed in your navigation. [Hidden pages](/organize/hidden-pages) are not included in the archive.
 </Note>
 
+### Security considerations
+
+The exported archive is a static, unauthenticated bundle. Anyone with the zip file can view every page it contains.
+
+- The `--groups` flag controls which group-restricted pages Mintlify includes in the archive at export time. It does not enforce authentication after export.
+- Only share archives with recipients who are allowed to see the content they contain.
+- Regenerate and redistribute the archive to publish new changes. Anyone running an older zip continues to see the older content.
+
 ## What's in the zip
 
 The exported archive contains everything needed to view your docs offline:

diff --git a/deploy/preview-deployments.mdx b/deploy/preview-deployments.mdx
@@ -111,6 +111,8 @@ Preview deployments stay live as long as their source branch exists in your repo
 
 Preview URLs are unique per branch. If you delete a preview and later recreate one for the same branch, Mintlify may issue a new URL.
 
+Mintlify generates preview URLs automatically. The subdomain and domain are not configurable, and custom domains only apply to your production deployment.
+
 ## Troubleshooting preview deployments
 
 If your preview deployment fails, try these troubleshooting steps.

diff --git a/es/api/introduction.mdx b/es/api/introduction.mdx
@@ -45,13 +45,12 @@ La REST (Representational State Transfer) API de Mintlify te permite interactuar
   ## URL base
 </div>
 
-Todos los endpoints de la API REST de Mintlify se sirven desde:
+Todas las solicitudes a la API REST de Mintlify usan la siguiente URL base:
 
 ```
 https://api.mintlify.com
 ```
 
-La página de referencia de cada endpoint indica la ruta completa y el método HTTP que se debe llamar.
 
 <div id="authentication">
   ## Autenticación

diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
@@ -18,6 +18,19 @@ Puedes configurar autenticación completa para todas las páginas o autenticaci
 
 La autenticación solo está disponible para sitios alojados en un dominio personalizado o subdominio de Mintlify. Por ejemplo, `docs.ejemplo.com` o `ejemplo.mintlify.site`. La autenticación **no es compatible** para sitios con una [subruta personalizada](/es/deploy/docs-subpath). Por ejemplo, `ejemplo.com/docs`.
 
+<div id="choose-an-authentication-method">
+  ## Elige un método de autenticación
+</div>
+
+Usa esta comparación para elegir el método que se adapte a tu caso de uso. Consulta [Disponibilidad de funciones](#feature-availability) para ver cómo interactúa cada método con otras funciones de Mintlify.
+
+| Método | Ideal para | Plan | Control de acceso basado en grupos | Autocompletado del área de pruebas de la API | Personalización |
+| :--- | :--- | :--- | :---: | :---: | :---: |
+| Contraseña | Acceso compartido sencillo sin seguimiento por usuario | Pro o Enterprise | — | — | — |
+| Autenticación privada | Documentación interna para miembros de tu organización de Mintlify | Todos los planes | — | — | — |
+| OAuth 2.0 | Proveedor de identidad existente o SSO con sesiones por usuario | Enterprise | ✓ | ✓ | ✓ |
+| JWT | Backend de autenticación personalizado o documentación integrada detrás de tu propio inicio de sesión | Enterprise | ✓ | ✓ | ✓ |
+
 <div id="configure-authentication">
   ## Configurar la autenticación
 </div>

diff --git a/es/deploy/export.mdx b/es/deploy/export.mdx
@@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise
   La exportación solo incluye las páginas listadas en tu navegación. Las [páginas ocultas](/es/organize/hidden-pages) no se incluyen en el archivo.
 </Note>
 
+<div id="security-considerations">
+  ### Consideraciones de seguridad
+</div>
+
+El archivo exportado es un paquete estático y sin autenticación. Cualquier persona que tenga el archivo zip puede ver todas las páginas que contiene.
+
+- El flag `--groups` controla qué páginas restringidas por grupo incluye Mintlify en el archivo al momento de exportar. **No** aplica autenticación después de la exportación.
+- Comparte los archivos únicamente con destinatarios autorizados a ver el contenido que contienen.
+- Regenera y vuelve a distribuir el archivo para publicar nuevos cambios: los destinatarios que ejecuten un zip anterior seguirán viendo el contenido anterior.
+
 <div id="whats-in-the-zip">
   ## Qué contiene el zip
 </div>

diff --git a/es/deploy/preview-deployments.mdx b/es/deploy/preview-deployments.mdx
@@ -132,6 +132,8 @@ Las implementaciones de vista previa se mantienen activas mientras la rama de or
 
 Las URLs de vista previa son únicas por rama. Si eliminas una vista previa y más tarde vuelves a crear otra para la misma rama, Mintlify puede emitir una nueva URL.
 
+Mintlify genera las URLs de vista previa automáticamente. El subdominio y el dominio no son configurables, y los dominios personalizados están reservados para tu implementación en producción.
+
 <div id="troubleshooting-preview-deployments">
   ## Solución de problemas con las implementaciones de vista previa
 </div>

diff --git a/fr/api/introduction.mdx b/fr/api/introduction.mdx
@@ -45,13 +45,12 @@ L'API REST (Representational State Transfer) de Mintlify vous permet d'interagir
   ## URL de base
 </div>
 
-Tous les endpoints de l'API REST Mintlify sont accessibles depuis :
+Toutes les requêtes vers l'API REST Mintlify utilisent l'URL de base suivante :
 
 ```
 https://api.mintlify.com
 ```
 
-La page de référence de chaque endpoint indique le chemin complet et la méthode HTTP à appeler.
 
 <div id="authentication">
   ## Authentification

diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
@@ -18,6 +18,19 @@ Vous pouvez configurer une authentification complète pour toutes les pages ou u
 
 L'authentification n'est disponible que pour les sites hébergés sur un domaine personnalisé ou un sous-domaine Mintlify. Par exemple, `docs.exemple.com` ou `exemple.mintlify.site`. L'authentification **n'est pas prise en charge** pour les sites avec un [sous-chemin personnalisé](/fr/deploy/docs-subpath). Par exemple, `exemple.com/docs`.
 
+<div id="choose-an-authentication-method">
+  ## Choisir une méthode d'authentification
+</div>
+
+Utilisez ce comparatif pour choisir la méthode adaptée à votre cas d'usage. Consultez [Disponibilité des fonctionnalités](#feature-availability) pour savoir comment chaque méthode interagit avec les autres fonctionnalités de Mintlify.
+
+| Méthode | Idéal pour | Offre | Accès basé sur les groupes | Pré-remplissage du bac à sable d'API | Personnalisation |
+| :--- | :--- | :--- | :---: | :---: | :---: |
+| Password | Accès partagé simple sans suivi par utilisateur | Pro ou Enterprise | — | — | — |
+| Private authentication | Documentation interne pour les membres de votre organisation Mintlify | Toutes les offres | — | — | — |
+| OAuth 2.0 | Fournisseur d'identité existant ou SSO avec sessions par utilisateur | Enterprise | ✓ | ✓ | ✓ |
+| JWT | Backend d'authentification personnalisé ou documentation intégrée derrière votre propre connexion | Enterprise | ✓ | ✓ | ✓ |
+
 <div id="configure-authentication">
   ## Configurer l’authentification
 </div>

diff --git a/fr/deploy/export.mdx b/fr/deploy/export.mdx
@@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise
   L'exportation inclut uniquement les pages listées dans votre navigation. Les [pages masquées](/fr/organize/hidden-pages) ne sont pas incluses dans l'archive.
 </Note>
 
+<div id="security-considerations">
+  ### Considérations de sécurité
+</div>
+
+L'archive exportée est un bundle statique et non authentifié. Toute personne disposant du fichier zip peut consulter chaque page qu'il contient.
+
+- L'option `--groups` contrôle quelles pages à accès restreint par groupe Mintlify inclut dans l'archive au moment de l'exportation. Elle **n'applique pas** d'authentification après l'exportation.
+- Ne partagez les archives qu'avec des destinataires autorisés à voir le contenu qu'elles contiennent.
+- Régénérez et redistribuez l'archive pour publier de nouvelles modifications — les destinataires qui utilisent un zip plus ancien continueront à voir l'ancien contenu.
+
 <div id="whats-in-the-zip">
   ## Contenu du zip
 </div>

diff --git a/fr/deploy/preview-deployments.mdx b/fr/deploy/preview-deployments.mdx
@@ -134,6 +134,8 @@ Les déploiements de prévisualisation restent disponibles tant que leur branche
 
 Les URL d'aperçu sont uniques par branche. Si vous supprimez un aperçu puis en recréez un pour la même branche, Mintlify peut émettre une nouvelle URL.
 
+Mintlify génère automatiquement les URL d'aperçu. Le sous-domaine et le domaine ne sont pas configurables, et les domaines personnalisés sont réservés à votre déploiement en production.
+
 <div id="troubleshooting-preview-deployments">
   ## Dépannage des déploiements de prévisualisation
 </div>

diff --git a/zh/api/introduction.mdx b/zh/api/introduction.mdx
@@ -45,13 +45,12 @@ Mintlify 的 REST（Representational State Transfer）API 让你可以以编程
   ## 基础 URL
 </div>
 
-所有 Mintlify REST API 端点均由以下地址提供服务：
+所有 Mintlify REST API 请求都使用以下基础 URL：
 
 ```
 https://api.mintlify.com
 ```
 
-每个端点的参考页面都会列出要调用的完整路径和 HTTP 方法。
 
 <div id="authentication">
   ## 认证

diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx
@@ -18,6 +18,19 @@ keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password', 'private']
 
 认证仅适用于托管在自定义域名或 Mintlify 子域名上的站点。例如，`docs.example.com` 或 `example.mintlify.site`。使用[自定义子路径](/zh/deploy/docs-subpath)的站点**不支持**认证。例如，`example.com/docs`。
 
+<div id="choose-an-authentication-method">
+  ## 选择认证方式
+</div>
+
+使用下方对比表来选择适合你使用场景的认证方式。请参见[功能可用性](#feature-availability) 了解每种方式如何与其他 Mintlify 功能协同工作。
+
+| 方式 | 适用场景 | 方案 | 基于用户组的访问控制 | API 操作台预填 | 个性化 |
+| :--- | :--- | :--- | :---: | :---: | :---: |
+| Password | 简单的共享访问，无需按用户跟踪 | Pro 或 Enterprise | — | — | — |
+| Private authentication | 面向 Mintlify 组织成员的内部文档 | 所有方案 | — | — | — |
+| OAuth 2.0 | 已有身份提供方或 SSO，且需要按用户会话 | Enterprise | ✓ | ✓ | ✓ |
+| JWT | 自定义认证后端或嵌入在自有登录后的文档 | Enterprise | ✓ | ✓ | ✓ |
+
 <div id="configure-authentication">
   ## 配置认证
 </div>

diff --git a/zh/deploy/export.mdx b/zh/deploy/export.mdx
@@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise
   导出仅包含导航中列出的页面。[隐藏页面](/zh/organize/hidden-pages) 不会包含在归档中。
 </Note>
 
+<div id="security-considerations">
+  ### 安全注意事项
+</div>
+
+导出的归档是一个静态、无需认证的压缩包。任何持有该 zip 文件的人都可以查看其中包含的每个页面。
+
+- `--groups` 标志用于控制在导出时 Mintlify 将哪些受用户组限制的页面包含到归档中。它**不会**在导出后强制执行认证。
+- 只与被允许查看归档内容的收件人分享归档文件。
+- 若要发布新的更改，请重新生成并重新分发归档—使用旧 zip 的收件人将继续看到旧的内容。
+
 <div id="whats-in-the-zip">
   ## zip 中的内容
 </div>

diff --git a/zh/deploy/preview-deployments.mdx b/zh/deploy/preview-deployments.mdx
@@ -134,6 +134,8 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging
 
 预览 URL 按 branch 唯一。如果你删除了某个预览，之后又为同一 branch 重新创建预览，Mintlify 可能会分配一个新的 URL。
 
+Mintlify 会自动生成预览 URL。子域名和域名不可配置，自定义域名仅保留用于你的生产部署。
+
 <div id="troubleshooting-preview-deployments">
   ## 预览部署故障排查
 </div>