From 9cdb960afae13b3f8f3a10eec52898b65c4fd69f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 05:08:22 +0000 Subject: [PATCH] docs: clarify llms-full.txt public access on partially authed sites --- ai/llmstxt.mdx | 4 +++- deploy/authentication-setup.mdx | 5 +++-- es/ai/llmstxt.mdx | 4 +++- es/deploy/authentication-setup.mdx | 5 +++-- fr/ai/llmstxt.mdx | 4 +++- fr/deploy/authentication-setup.mdx | 5 +++-- 6 files changed, 18 insertions(+), 9 deletions(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index b17e66db43..76487a3cb1 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -12,7 +12,9 @@ The [llms.txt file](https://llmstxt.org) is an industry standard that helps LLMs 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. - 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). + If your site is fully authenticated, `llms.txt` and `llms-full.txt` require authentication to view, so LLMs and AI tools that cannot sign in cannot access these files. + + If your site is partially authenticated, `llms.txt` requires authentication, but `llms-full.txt` is publicly accessible and automatically excludes pages that require authentication or belong to [user groups](/deploy/authentication-setup#control-access-with-groups). This lets AI tools index your public content without signing in while keeping protected pages private. For more information on how authentication affects AI features, see [Feature availability](/deploy/authentication-setup#feature-availability). diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index fe9b86142a..b0c18fafe5 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -460,11 +460,12 @@ type User = { ## 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. Hosted files like `llms.txt` and `skill.md` are subject to the same authentication requirements as your documentation pages. `llms-full.txt`, `sitemap.xml`, and `robots.txt` remain publicly accessible on partially authenticated sites and exclude pages that require authentication. | 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](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the file | Available behind authentication, so AI tools may not be able to access the file | +| [llms-full.txt](/ai/llmstxt#llms-fulltxt) | Full support | Available behind authentication, so AI tools may not be able to access the file | Available without authentication, excludes pages in groups and pages that require authentication | | [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 index 3651bb2c4b..30d9a62072 100644 --- a/es/ai/llmstxt.mdx +++ b/es/ai/llmstxt.mdx @@ -12,7 +12,9 @@ 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. - 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). + Si tu sitio está totalmente autenticado, `llms.txt` y `llms-full.txt` requieren autenticación para poder verse, por lo que los LLM y las herramientas de IA que no puedan iniciar sesión no pueden acceder a estos archivos. + + Si tu sitio está parcialmente autenticado, `llms.txt` requiere autenticación, pero `llms-full.txt` es de acceso público y excluye automáticamente las páginas que requieren autenticación o pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups). Esto permite que las herramientas de IA indexen tu contenido público sin iniciar sesión y, al mismo tiempo, mantiene privadas las páginas protegidas. 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). diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 8a7799fef1..33e565a946 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -492,11 +492,12 @@ Cuando utilices autenticación OAuth o JWT, tu sistema devolverá datos de usuar ## Disponibilidad de funciones -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. Los archivos alojados como `llms.txt` y `skill.md` están sujetos a los mismos requisitos de autenticación que las páginas de tu documentación. `llms-full.txt`, `sitemap.xml` y `robots.txt` siguen siendo de acceso público en sitios parcialmente autenticados y excluyen las páginas que requieren autenticació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](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder al archivo | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder al archivo | +| [llms-full.txt](/es/ai/llmstxt#llms-fulltxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder al archivo | Disponible sin autenticación, excluye las páginas en grupos y las páginas que requieren autenticación | | [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 index 966b22071a..a316d6b3e6 100644 --- a/fr/ai/llmstxt.mdx +++ b/fr/ai/llmstxt.mdx @@ -12,7 +12,9 @@ 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. - 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). + Si votre site est entièrement authentifié, `llms.txt` et `llms-full.txt` nécessitent une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas se connecter ne peuvent pas accéder à ces fichiers. + + Si votre site est partiellement authentifié, `llms.txt` nécessite une authentification, mais `llms-full.txt` est accessible publiquement et exclut automatiquement les pages qui nécessitent une authentification ou appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups). Cela permet aux outils d'IA d'indexer votre contenu public sans se connecter, tout en gardant les pages protégées privées. 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). diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index ed46445ae2..823ba2b8d7 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -492,11 +492,12 @@ Lorsque vous utilisez l’authentification OAuth ou JWT, votre système renvoie ## Disponibilité des fonctionnalités -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é. Les fichiers hébergés comme `llms.txt` et `skill.md` sont soumis aux mêmes exigences d’authentification que vos pages de documentation. `llms-full.txt`, `sitemap.xml` et `robots.txt` restent accessibles publiquement sur les sites partiellement authentifiés et excluent les pages qui nécessitent une authentification. | 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](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès au fichier | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès au fichier | +| [llms-full.txt](/fr/ai/llmstxt#llms-fulltxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès au fichier | Disponible sans authentification, exclut les pages dans des groupes et les pages qui nécessitent une authentification | | [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 |