mintlify · mintlify · Sep 4, 2026 · Sep 4, 2026
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
@@ -30,7 +30,7 @@
 - `X-Llms-Txt`: A convenience header for tools that check for `llms.txt` support.

 ```http Response headers
 Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt", </.well-known/api-catalog>; rel="api-catalog", </.well-known/mcp/server-card.json>; rel="mcp-server-card", </.well-known/agent-card.json>; rel="agent-card", </.well-known/agent-skills/index.json>; rel="agent-skills"
 X-Llms-Txt: /llms.txt
 ```

@@ -69,14 +69,14 @@
 - [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
 ```

 A generated index can link to further indexes. For example, `/_llms/api-reference.md` can link to `/_llms/api-reference/admin.md` when a group is too large for a single file. Agents should follow these index links recursively until they reach documentation page links. Mintlify may shorten page descriptions in a split index to keep each file under the character limit.

 The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.

 The `/_llms/` route uses the same base path as your documentation:

 - A root-hosted site serves an index at `https://docs.example.com/_llms/api-reference.md`.
 - A site hosted at `/docs` serves it at `https://example.com/docs/_llms/api-reference.md`.

 If you use a reverse proxy or path allowlist, forward the generated route in addition to `llms.txt`. A broad `<base-path>/*` rule already includes `<base-path>/_llms/*`. With granular rules, add `<base-path>/_llms/*` explicitly. See [Reverse proxy](/deploy/reverse-proxy#routing-configuration) for routing guidance.

@@ -114,6 +114,10 @@
 
 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.
 
+<Note>
+  The [Don't index project](/optimize/seo#disable-indexing-for-the-entire-project) setting returns `404` for `llms.txt` but does not affect `llms-full.txt`.
+</Note>
+
 <PreviewButton href="https://mintlify.com/docs/llms-full.txt">Open the llms-full.txt for this site.</PreviewButton>
 
 ## Custom files

diff --git a/docs.json b/docs.json
@@ -481,7 +481,9 @@
                   "help-center/preview-deployment-not-created-for-fork-branch",
                   "help-center/branch-missing-from-editor-branch-list",
                   "help-center/style-card-icons-with-custom-css",
-                  "help-center/can-i-rename-my-deployment-or-organization"
+                  "help-center/can-i-rename-my-deployment-or-organization",
+                  "help-center/llms-txt-returns-404-but-llms-full-txt-works",
+                  "help-center/site-search-returns-no-results"
                 ]
               }
             ]

diff --git a/es.json b/es.json
@@ -459,7 +459,9 @@
             "es/help-center/preview-deployment-not-created-for-fork-branch",
             "es/help-center/branch-missing-from-editor-branch-list",
             "es/help-center/style-card-icons-with-custom-css",
-            "es/help-center/can-i-rename-my-deployment-or-organization"
+            "es/help-center/can-i-rename-my-deployment-or-organization",
+            "es/help-center/llms-txt-returns-404-but-llms-full-txt-works",
+            "es/help-center/site-search-returns-no-results"
           ]
         }
       ]

diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
@@ -120,6 +120,10 @@ El archivo `llms-full.txt` reúne todo tu sitio de documentación en un único a
 
 Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Visualiza tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. Mintlify también aloja el archivo en `/.well-known/llms-full.txt` para garantizar la compatibilidad con herramientas que siguen la convención `.well-known`.
 
+<Note>
+  La opción [Don't index project](/es/optimize/seo#disable-indexing-for-the-entire-project) devuelve `404` para `llms.txt`, pero no afecta a `llms-full.txt`.
+</Note>
+
 <PreviewButton href="https://mintlify.com/docs/llms-full.txt">Abrir el llms-full.txt de este sitio.</PreviewButton>
 
 <div id="custom-files">

diff --git a/es/help-center/llms-txt-returns-404-but-llms-full-txt-works.mdx b/es/help-center/llms-txt-returns-404-but-llms-full-txt-works.mdx
@@ -0,0 +1,32 @@
+---
+title: "llms.txt devuelve 404 pero llms-full.txt funciona"
+description: "Diagnostica por qué el llms.txt de tu sitio devuelve un error 404 mientras llms-full.txt carga, normalmente por la opción Don't index project."
+keywords: ["llms.txt 404", "llms.txt not found", "llms-full.txt works", "no llms.txt", "don't index project", "noindex"]
+---
+
+Mintlify aloja automáticamente un archivo [`llms.txt`](/es/ai/llmstxt) en la raíz de cada sitio de documentación. Si `https://yourdocs.com/llms.txt` devuelve `404` mientras `https://yourdocs.com/llms-full.txt` carga con normalidad, la causa más probable es la opción **Don't index project**.
+
+<div id="check-the-dont-index-project-setting">
+## Comprueba la opción Don't index project
+</div>
+
+Cuando activas **Don't index project** en la página [Add-ons](https://app.mintlify.com/settings/deployment/addons) de tu panel, Mintlify devuelve `404` para `llms.txt` y `/.well-known/llms.txt`. La opción no bloquea `llms-full.txt`, que sigue disponible. Esta discrepancia hace que la ausencia de `llms.txt` parezca un error del despliegue cuando en realidad es un comportamiento configurado.
+
+La exportación en Markdown de cada página (la URL `.md`) también conserva su referencia a `/llms.txt` mientras la opción está activada, aunque esa URL devuelva `404`.
+
+Para restaurar `llms.txt`:
+
+1. Abre la página [Add-ons](https://app.mintlify.com/settings/deployment/addons) de tu panel.
+2. Desactiva **Don't index project**.
+3. Espera a que se complete el redespliegue. Activar o desactivar la indexación redespliega tu sitio, y el cambio surte efecto una vez finalizado el redespliegue.
+
+Consulta [Desactivar la indexación de todo el proyecto](/es/optimize/seo#disable-indexing-for-the-entire-project) para conocer todo lo demás que controla esta opción.
+
+<div id="other-causes">
+## Otras causas
+</div>
+
+Si **Don't index project** está desactivada y `llms.txt` sigue devolviendo `404`:
+
+- **Autenticación**: en los sitios totalmente autenticados, tanto `llms.txt` como `llms-full.txt` requieren autenticación. Las solicitudes no autenticadas fallan para ambos archivos, no solo para `llms.txt`. Consulta [llms.txt](/es/ai/llmstxt) para ver cómo la autenticación afecta a cada archivo.
+- **Enrutamiento del proxy inverso**: si sirves tu documentación a través de un proxy inverso con una lista de rutas permitidas, confirma que el proxy reenvía `/llms.txt` y `/.well-known/llms.txt`. Consulta [Proxy inverso](/es/deploy/reverse-proxy#routing-configuration).
diff --git a/es/help-center/site-search-returns-no-results.mdx b/es/help-center/site-search-returns-no-results.mdx
@@ -0,0 +1,48 @@
+---
+title: "Solucionar que la búsqueda del sitio no devuelva resultados"
+description: "Diagnostica por qué la búsqueda integrada de tu documentación no devuelve resultados, a menudo por hidden: true en una versión de docs.json."
+keywords: ["search returns no results", "empty search", "search broken", "hidden version", "search index empty", "site search"]
+---
+
+Si la búsqueda integrada de tu sitio de documentación de Mintlify no devuelve resultados para ninguna consulta, incluidos los títulos exactos de las páginas, lo más probable es que tus páginas estén excluidas del índice de búsqueda por un ajuste `hidden` en tu `docs.json`.
+
+<div id="check-for-hidden-true-on-a-version-or-other-top-level-navigation-element">
+## Busca `hidden: true` en una versión u otro elemento de navegación de nivel superior
+</div>
+
+Establecer `hidden: true` en una versión, un anclaje, un menú desplegable, un idioma o un producto en tu `docs.json` excluye del índice de búsqueda todas las páginas que contiene. Si ese elemento contiene todas tus páginas, como tu única versión, el índice de búsqueda queda vacío y todas las búsquedas devuelven nada. El sitio en sí sigue funcionando porque las páginas ocultas permanecen accesibles por URL directa.
+
+```json Example: this hides every page from search
+"navigation": {
+  "versions": [
+    {
+      "version": "v1",
+      "hidden": true,
+      "groups": [...]
+    }
+  ]
+}
+```
+
+Para solucionarlo, elige una de las siguientes opciones:
+
+- Elimina `hidden: true` de la versión o del otro elemento.
+- Mantén el elemento oculto en la navegación, pero devuelve sus páginas a la búsqueda y la indexación estableciendo `seo.indexing: "all"` en tu `docs.json`:
+
+  ```json
+  "seo": {
+    "indexing": "all"
+  }
+  ```
+
+A diferencia de las pestañas y los grupos, las versiones y otros elementos de navegación de nivel superior no admiten la inclusión mediante `searchable: true`. Consulta [Páginas ocultas](/es/organize/hidden-pages#search-seo-and-ai-indexing) para ver el comportamiento completo de visibilidad e indexación de cada ubicación de `hidden`.
+
+La búsqueda se vuelve a indexar cuando tu sitio se reconstruye, así que envía el cambio de `docs.json` y espera a que se complete el despliegue antes de volver a probar.
+
+<div id="other-causes">
+## Otras causas
+</div>
+
+- **Pestañas o grupos ocultos**: `hidden: true` en una pestaña o un grupo también excluye sus páginas de la búsqueda. En pestañas y grupos, puedes añadir `searchable: true` junto a `hidden: true` para que las páginas descendientes sigan siendo localizables. Consulta [Incluir páginas bajo pestañas o grupos ocultos específicos](/es/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups).
+- **Páginas ausentes de la navegación**: las páginas que no aparecen en la navegación de tu `docs.json` se excluyen de la búsqueda de forma predeterminada.
+- **Frontmatter de la página**: `hidden: true`, `noindex: true` o `searchable: false` en el frontmatter de una página excluyen esa página de la búsqueda del sitio.
diff --git a/es/optimize/seo.mdx b/es/optimize/seo.mdx
@@ -472,7 +472,7 @@ Cuando se activa, Mintlify:
 
 - Renderiza todas las páginas con las metaetiquetas robots `noindex, nofollow`.
 - Devuelve un `sitemap.xml` vacío.
-- Devuelve `404` para `llms.txt` y `llms-full.txt`.
+- Devuelve `404` para `llms.txt`, incluso en `/.well-known/llms.txt`.
 - Elimina tus páginas de [Mintlify Index](/es/search-index), de modo que los agentes de código ya no puedan recuperar tu contenido allí.
 - Sirve un `robots.txt` que bloquea todo el sitio:
 
@@ -484,6 +484,10 @@ Cuando se activa, Mintlify:
 
 Tu búsqueda integrada en el producto, el [asistente](/es/assistant/index) y el [servidor MCP](/es/ai/model-context-protocol) siguen funcionando. Para eliminar páginas de esas superficies, usa `noindex: true` o `searchable: false` en páginas individuales.
 
+<Note>
+  **Don't index project** no bloquea [`llms-full.txt`](/es/ai/llmstxt#llms-fulltxt), que sigue disponible en `/llms-full.txt`. La exportación en Markdown de cada página también conserva su referencia a `/llms.txt`, aunque ese archivo devuelva `404` mientras la opción está activada. Si tu `llms.txt` devuelve `404` pero `llms-full.txt` funciona, revisa esta opción. Consulta [Solucionar que llms.txt devuelva 404 mientras llms-full.txt funciona](/es/help-center/llms-txt-returns-404-but-llms-full-txt-works).
+</Note>
+
 Usa esta opción cuando quieras mantener un despliegue en línea para revisión interna, pruebas o uso compartido limitado, pero no quieras que aparezca en los resultados públicos de búsqueda ni que se utilice como datos de entrenamiento o de recuperación para herramientas de IA.
 
 <Note>

diff --git a/es/organize/hidden-pages.mdx b/es/organize/hidden-pages.mdx
@@ -102,6 +102,30 @@ Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `do
 ]
 ```
 
+<div id="hide-a-version-or-other-top-level-navigation-element">
+  ### Ocultar una versión u otro elemento de navegación de nivel superior
+</div>
+
+Las versiones, los anclajes, los menús desplegables, los idiomas y los productos también aceptan la propiedad `hidden`. Establecer `hidden: true` en uno de estos elementos lo elimina de la navegación renderizada y excluye todas las páginas que contiene de la búsqueda del sitio, los sitemaps, la indexación en motores de búsqueda y el contexto de IA.
+
+```json highlight={4}
+"versions": [
+  {
+    "version": "v1",
+    "hidden": true,
+    "groups": [...]
+  },
+  {
+    "version": "v2",
+    "groups": [...]
+  }
+]
+```
+
+<Warning>
+  Si estableces `hidden: true` en tu única versión, o en la versión que contiene todas tus páginas, el índice de búsqueda de tu sitio queda vacío y las búsquedas no devuelven resultados. A diferencia de las pestañas y los grupos, las versiones no admiten `searchable: true`. Para que las versiones ocultas vuelvan a la búsqueda y la indexación, elimina `hidden: true` de la versión o establece `seo.indexing: "all"` en tu `docs.json`. Consulta [Solucionar que la búsqueda del sitio no devuelva resultados](/es/help-center/site-search-returns-no-results).
+</Warning>
+
 <div id="search-seo-and-ai-indexing">
   ## Búsqueda, SEO e indexación de IA
 </div>
@@ -113,6 +137,7 @@ La siguiente tabla resume cómo cada propiedad afecta la visibilidad y la indexa
 | Propiedad | Navegación lateral | Búsqueda del sitio | Sitemap | Indexación en motores de búsqueda | Contexto del assistant de IA | `llms.txt` |
 |---|---|---|---|---|---|---|
 | `hidden: true` (frontmatter de la página) | Oculta | Excluida | Excluida | Excluida | Excluida | Excluida |
+| `hidden: true` (versión u otro elemento de navegación de nivel superior) | Oculta | Excluida | Excluida | Excluida | Excluida | Excluida |
 | Página no listada en `docs.json` | Oculta | Excluida | Excluida | Excluida solo del sitemap | Excluida | Excluida |
 | `noindex: true` (frontmatter de la página) | Visible | Excluida | Excluida | Excluida | Excluida | Excluida |
 | `searchable: false` (frontmatter de la página) | Visible | Excluida | Incluida | Incluida | Excluida | Incluida |

diff --git a/fr.json b/fr.json
@@ -459,7 +459,9 @@
             "fr/help-center/preview-deployment-not-created-for-fork-branch",
             "fr/help-center/branch-missing-from-editor-branch-list",
             "fr/help-center/style-card-icons-with-custom-css",
-            "fr/help-center/can-i-rename-my-deployment-or-organization"
+            "fr/help-center/can-i-rename-my-deployment-or-organization",
+            "fr/help-center/llms-txt-returns-404-but-llms-full-txt-works",
+            "fr/help-center/site-search-returns-no-results"
           ]
         }
       ]

diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
@@ -120,6 +120,10 @@ Le fichier `llms-full.txt` regroupe l'intégralité de votre site de documentati
 
 Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de votre projet. Affichez votre `llms-full.txt` en ajoutant `/llms-full.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms-full.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.
 
+<Note>
+  Le paramètre [Don't index project](/fr/optimize/seo#disable-indexing-for-the-entire-project) renvoie `404` pour `llms.txt`, mais n'affecte pas `llms-full.txt`.
+</Note>
+
 <PreviewButton href="https://mintlify.com/docs/llms-full.txt">Ouvrir le llms-full.txt de ce site</PreviewButton>
 
 <div id="custom-files">

diff --git a/fr/help-center/llms-txt-returns-404-but-llms-full-txt-works.mdx b/fr/help-center/llms-txt-returns-404-but-llms-full-txt-works.mdx
@@ -0,0 +1,32 @@
+---
+title: "llms.txt renvoie 404 mais llms-full.txt fonctionne"
+description: "Diagnostiquez pourquoi le llms.txt de votre site renvoie une erreur 404 alors que llms-full.txt se charge, souvent dû au paramètre Don't index project."
+keywords: ["llms.txt 404", "llms.txt not found", "llms-full.txt works", "no llms.txt", "don't index project", "noindex"]
+---
+
+Mintlify héberge automatiquement un fichier [`llms.txt`](/fr/ai/llmstxt) à la racine de chaque site de documentation. Si `https://yourdocs.com/llms.txt` renvoie `404` alors que `https://yourdocs.com/llms-full.txt` se charge normalement, la cause la plus probable est le paramètre **Don't index project**.
+
+<div id="check-the-dont-index-project-setting">
+## Vérifier le paramètre Don't index project
+</div>
+
+Lorsque vous activez **Don't index project** sur la page [Add-ons](https://app.mintlify.com/settings/deployment/addons) de votre tableau de bord, Mintlify renvoie `404` pour `llms.txt` et `/.well-known/llms.txt`. Ce paramètre ne bloque pas `llms-full.txt`, qui reste disponible. Cette différence donne l'impression que l'absence de `llms.txt` est un bug de déploiement, alors qu'il s'agit d'un comportement configuré.
+
+L'export Markdown de chaque page (l'URL `.md`) conserve également son pointeur vers `/llms.txt` tant que le paramètre est activé, même si cette URL renvoie `404`.
+
+Pour rétablir `llms.txt` :
+
+1. Ouvrez la page [Add-ons](https://app.mintlify.com/settings/deployment/addons) de votre tableau de bord.
+2. Désactivez **Don't index project**.
+3. Attendez la fin du redéploiement. Activer ou désactiver l'indexation redéploie votre site, et le changement prend effet une fois le redéploiement terminé.
+
+Consultez [Désactiver l'indexation pour l'ensemble du projet](/fr/optimize/seo#disable-indexing-for-the-entire-project) pour découvrir tout ce que ce paramètre contrôle par ailleurs.
+
+<div id="other-causes">
+## Autres causes
+</div>
+
+Si **Don't index project** est désactivé et que `llms.txt` renvoie toujours `404` :
+
+- **Authentification** : sur les sites entièrement authentifiés, `llms.txt` et `llms-full.txt` nécessitent tous deux une authentification. Les requêtes non authentifiées échouent pour les deux fichiers, pas seulement pour `llms.txt`. Consultez [llms.txt](/fr/ai/llmstxt) pour savoir comment l'authentification affecte chaque fichier.
+- **Routage du reverse proxy** : si vous servez votre documentation via un reverse proxy avec une liste d'autorisation de chemins, vérifiez que le proxy transfère `/llms.txt` et `/.well-known/llms.txt`. Consultez [Reverse proxy](/fr/deploy/reverse-proxy#routing-configuration).
diff --git a/fr/help-center/site-search-returns-no-results.mdx b/fr/help-center/site-search-returns-no-results.mdx
@@ -0,0 +1,48 @@
+---
+title: "La recherche du site ne renvoie aucun résultat"
+description: "Diagnostiquez pourquoi la recherche intégrée de votre site ne renvoie aucun résultat, souvent à cause de hidden: true sur une version dans docs.json."
+keywords: ["search returns no results", "empty search", "search broken", "hidden version", "search index empty", "site search"]
+---
+
+Si la recherche intégrée de votre site de documentation Mintlify ne renvoie aucun résultat, quelle que soit la requête, y compris les titres exacts de pages, vos pages sont probablement exclues de l'index de recherche par un paramètre `hidden` dans votre `docs.json`.
+
+<div id="check-for-hidden-true-on-a-version-or-other-top-level-navigation-element">
+## Vérifier la présence de `hidden: true` sur une version ou un autre élément de navigation de premier niveau
+</div>
+
+Définir `hidden: true` sur une version, une ancre, un menu déroulant, une langue ou un produit dans votre `docs.json` exclut chaque page qu'il contient de l'index de recherche. Si cet élément contient toutes vos pages, par exemple votre seule version, l'index de recherche devient vide et chaque recherche ne renvoie rien. Le site lui-même continue de fonctionner, car les pages masquées restent accessibles par URL directe.
+
+```json Example: this hides every page from search
+"navigation": {
+  "versions": [
+    {
+      "version": "v1",
+      "hidden": true,
+      "groups": [...]
+    }
+  ]
+}
+```
+
+Pour corriger le problème, choisissez l'une des options suivantes :
+
+- Retirez `hidden: true` de la version ou de l'autre élément.
+- Gardez l'élément masqué dans la navigation, mais réintégrez ses pages dans la recherche et l'indexation en définissant `seo.indexing: "all"` dans votre `docs.json` :
+
+  ```json
+  "seo": {
+    "indexing": "all"
+  }
+  ```
+
+Contrairement aux onglets et aux groupes, les versions et les autres éléments de navigation de premier niveau ne prennent pas en charge l'option `searchable: true`. Consultez [Pages masquées](/fr/organize/hidden-pages#search-seo-and-ai-indexing) pour le comportement complet de visibilité et d'indexation de chaque emplacement de `hidden`.
+
+La recherche se réindexe lorsque votre site est reconstruit ; poussez donc la modification de `docs.json` et attendez la fin du déploiement avant de tester à nouveau.
+
+<div id="other-causes">
+## Autres causes
+</div>
+
+- **Onglets ou groupes masqués** : `hidden: true` sur un onglet ou un groupe exclut également ses pages de la recherche. Pour les onglets et les groupes, vous pouvez ajouter `searchable: true` en plus de `hidden: true` pour garder les pages descendantes accessibles à la recherche. Consultez [Inclure les pages situées sous des onglets ou groupes masqués spécifiques](/fr/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups).
+- **Pages absentes de la navigation** : les pages qui ne figurent pas dans la navigation de votre `docs.json` sont exclues de la recherche par défaut.
+- **Frontmatter de la page** : `hidden: true`, `noindex: true` ou `searchable: false` dans le frontmatter d'une page excluent chacun cette page de la recherche du site.