mintlify · mintlify · May 15, 2026 · May 15, 2026
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
@@ -1,6 +1,6 @@
 ---
 title: "llms.txt"
 description: "Automatically generate llms.txt and llms-full.txt files so AI tools like ChatGPT and Claude can index and understand your documentation."
 keywords: ["llms.txt", "LLM indexing", "AEO", "GEO", "content discovery"]
 boost: 3
 ---
@@ -12,21 +12,25 @@
 Mintlify automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project.
 
 <Note>
-  If your site requires authentication, `llms.txt` and `llms-full.txt` also require authentication to view. LLMs and AI tools that cannot authenticate into your site cannot access these files. The files exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups).
+  How authentication affects `llms.txt` and `llms-full.txt`:
+
+  - **Public sites**: Both files are publicly accessible and include all pages.
+  - **Partially authenticated sites** (some pages marked `public: true`): Both files are publicly accessible and include only public pages. Pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups) or require authentication are excluded.
+  - **Fully authenticated sites** (all pages protected): Both files return a `404` and are not served. This prevents leaking page titles or descriptions to unauthenticated crawlers.
 
   For more information on how authentication affects AI features, see [Feature availability](/deploy/authentication-setup#feature-availability).
 </Note>

 View your `llms.txt` by appending `/llms.txt` to your documentation site's URL. Mintlify also hosts the file at `/.well-known/llms.txt` for compatibility with tools that follow the `.well-known` convention.

 <PreviewButton href="https://mintlify.com/docs/llms.txt">Open the llms.txt for this site.</PreviewButton>

 Mintlify adds HTTP headers to every page response so AI tools can discover your `llms.txt` files without prior knowledge of their location:

 - `Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"`: Follows the standard HTTP `Link` header format for resource discovery.
 - `X-Llms-Txt: /llms.txt`: A convenience header for tools that check for `llms.txt` support.

 ## llms.txt structure

 An `llms.txt` file is a plain Markdown file that contains:

@@ -67,7 +71,7 @@

 Mintlify automatically hosts an `llms-full.txt` file at the root of your project. View your `llms-full.txt` by appending `/llms-full.txt` to your documentation site's URL. Mintlify also hosts the file at `/.well-known/llms-full.txt` for compatibility with tools that follow the `.well-known` convention.

 <PreviewButton href="https://mintlify.com/docs/llms-full.txt">Open the llms-full.txt for this site.</PreviewButton>

 ## Custom files


diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
@@ -104,8 +104,8 @@
      * **Scopes** (optional): Permissions to request. Copy the **entire** scope string (for example, for a scope like `provider.users.docs`, copy the complete `provider.users.docs`). Use multiple scopes if you need different access levels.
      * **Additional authorization parameters** (optional): Additional query parameters to add to the initial authorization request.
      * **Token URL**: Your OAuth token exchange endpoint.
      * **Info API URL** (optional): Endpoint on your server that Mintlify calls to retrieve user info. Required for group-based access control. If omitted, the OAuth flow only verifies identity.
      * **Logout URL** (optional): The native logout URL for your OAuth provider. When users log out, Mintlify validates the logout redirect against this configured URL for security. The redirect only succeeds if it exactly matches the configured `logoutUrl`. If you do not configure a logout URL, users redirect to `/login`. Mintlify redirects users with a `GET` request and does not append query parameters, so include any parameters (for example, `returnTo`) directly in the URL.
      * **Redirect URL** (optional): The URL to redirect users to after authentication.
    5. Click **Save changes**.

@@ -137,7 +137,7 @@
 - **Scopes**: `['provider.users.docs']`
 - **Token URL**: `https://auth.foo.com/exchange`
 - **Info API URL**: `https://api.foo.com/docs/user-info`
 - **Logout URL**: `https://auth.foo.com/logout?returnTo=https%3A%2F%2Ffoo.com%2Fdocs`

 **Create a user info endpoint** at `api.foo.com/docs/user-info`, which requires an OAuth access token with the `provider.users.docs` scope, and returns:

@@ -460,11 +460,11 @@
 
 ## Feature availability
 
-Some features behave differently or are unavailable when you enable authentication. Mintlify does not support serving arbitrary files publicly on an authenticated site. All hosted files, including `llms.txt`, `llms-full.txt`, and `skill.md`, are subject to the same authentication requirements as your documentation pages.
+Some features behave differently or are unavailable when you enable authentication. Mintlify does not support serving arbitrary files publicly on an authenticated site. With the exception of `llms.txt` and `llms-full.txt` on partially authenticated sites, hosted files like `skill.md` are subject to the same authentication requirements as your documentation pages.
 
 | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) |
 | :------ | :---------- | :---------------------------------- | :-------------------------------- |
-| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Available behind authentication, so AI tools may not be able to access the files |
+| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Not served (returns `404`) | Publicly accessible, limited to public pages only |
 | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages |
 | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups |
 | [PDF export](/optimize/pdf-exports) | Full support | Not supported | Not supported |

diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
@@ -12,7 +12,11 @@ El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda
 Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto que lista todas las páginas disponibles de tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes añadir un `llms.txt` personalizado en la raíz de tu proyecto.
 
 <Note>
-  Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups).
+  Cómo afecta la autenticación a `llms.txt` y `llms-full.txt`:
+
+  - **Sitios públicos**: Ambos archivos son de acceso público e incluyen todas las páginas.
+  - **Sitios parcialmente autenticados** (algunas páginas marcadas con `public: true`): Ambos archivos son de acceso público e incluyen solo las páginas públicas. Las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups) o que requieren autenticación se excluyen.
+  - **Sitios totalmente autenticados** (todas las páginas protegidas): Ambos archivos devuelven `404` y no se sirven. Esto evita filtrar los títulos o las descripciones de las páginas a rastreadores no autenticados.
 
   Para obtener más información sobre cómo la autenticación afecta las funciones de IA, consulta [Disponibilidad de funciones](/es/deploy/authentication-setup#feature-availability).
 </Note>

diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
@@ -492,11 +492,11 @@ Cuando utilices autenticación OAuth o JWT, tu sistema devolverá datos de usuar
   ## Disponibilidad de funciones
 </div>
 
-Algunas funciones se comportan de manera diferente o no están disponibles cuando habilitas la autenticación. Mintlify no admite el alojamiento público de archivos arbitrarios en un sitio autenticado. Todos los archivos alojados, incluidos `llms.txt`, `llms-full.txt` y `skill.md`, están sujetos a los mismos requisitos de autenticación que las páginas de tu documentación.
+Algunas funciones se comportan de manera diferente o no están disponibles cuando habilitas la autenticación. Mintlify no admite el alojamiento público de archivos arbitrarios en un sitio autenticado. Con la excepción de `llms.txt` y `llms-full.txt` en sitios parcialmente autenticados, los archivos alojados como `skill.md` están sujetos a los mismos requisitos de autenticación que las páginas de tu documentación.
 
 | Función                                                      | Público                 | Totalmente autenticado (todas las páginas protegidas)                                                            | Parcialmente autenticado (algunas páginas públicas)                                                              |
 | :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
-| [llms.txt and llms-full.txt](/es/ai/llmstxt)                    | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos |
+| [llms.txt and llms-full.txt](/es/ai/llmstxt)                    | Compatibilidad completa | No se sirve (devuelve `404`)                                                                                     | De acceso público, limitado solo a las páginas públicas                                                          |
 | [Servidor MCP](/es/ai/model-context-protocol)                   | Compatibilidad completa | Requiere autenticación para conectarse                                                                           | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas                   |
 | [Exportación a Markdown](/es/ai/markdown-export)                | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios                                                          | Compatibilidad completa, respeta los grupos de usuarios                                                          |
 | [Exportación a PDF](/es/optimize/pdf-exports)                   | Compatibilidad completa | No compatible                                                                                                    | No compatible                                                                                                    |

diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
@@ -12,7 +12,11 @@ Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les
 Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet.
 
 <Note>
-  Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups).
+  Comment l'authentification affecte `llms.txt` et `llms-full.txt` :
+
+  - **Sites publics** : Les deux fichiers sont accessibles publiquement et incluent toutes les pages.
+  - **Sites partiellement authentifiés** (certaines pages marquées `public: true`) : Les deux fichiers sont accessibles publiquement et incluent uniquement les pages publiques. Les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups) ou qui nécessitent une authentification sont exclues.
+  - **Sites entièrement authentifiés** (toutes les pages protégées) : Les deux fichiers renvoient un `404` et ne sont pas servis. Cela évite de divulguer les titres et les descriptions des pages aux robots d'indexation non authentifiés.
 
   Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/fr/deploy/authentication-setup#feature-availability).
 </Note>

diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
@@ -492,11 +492,11 @@ Lorsque vous utilisez l’authentification OAuth ou JWT, votre système renvoie
   ## Disponibilité des fonctionnalités
 </div>
 
-Certaines fonctionnalités se comportent différemment ou ne sont pas disponibles lorsque vous activez l’authentification. Mintlify ne prend pas en charge l’hébergement de fichiers publics arbitraires sur un site authentifié. Tous les fichiers hébergés, y compris `llms.txt`, `llms-full.txt` et `skill.md`, sont soumis aux mêmes exigences d’authentification que vos pages de documentation.
+Certaines fonctionnalités se comportent différemment ou ne sont pas disponibles lorsque vous activez l’authentification. Mintlify ne prend pas en charge l’hébergement de fichiers publics arbitraires sur un site authentifié. À l'exception de `llms.txt` et `llms-full.txt` sur les sites partiellement authentifiés, les fichiers hébergés tels que `skill.md` sont soumis aux mêmes exigences d’authentification que vos pages de documentation.
 
 | Fonctionnalité                                           | Public                   | Entièrement authentifié (toutes les pages protégées)                                                 | Partiellement authentifié (certaines pages publiques)                                                       |
 | :------------------------------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |
-| [llms.txt and llms-full.txt](/fr/ai/llmstxt)                | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers |
+| [llms.txt and llms-full.txt](/fr/ai/llmstxt)                | Prise en charge complète | Non servi (renvoie `404`)                                                                            | Accessible publiquement, limité aux pages publiques uniquement                                              |
 | [MCP server](/fr/ai/model-context-protocol)                 | Prise en charge complète | Nécessite une authentification pour se connecter                                                     | Disponible sans authentification pour les pages publiques et avec authentification pour les pages protégées |
 | [Markdown export](/fr/ai/markdown-export)                   | Prise en charge complète | Prise en charge complète, respecte les groupes d’utilisateurs                                        | Prise en charge complète, respecte les groupes d’utilisateurs                                               |
 | [Export PDF](/fr/optimize/pdf-exports)                      | Prise en charge complète | Non pris en charge                                                                                   | Non pris en charge                                                                                          |