From 5c19afabc3d33a4bebfbcf257954478e9f9f8ee9 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:14:47 +0000
Subject: [PATCH 1/3] docs: document project-level noindex setting
---
es/optimize/seo.mdx | 29 +++++++++++++++++++++++++++++
fr/optimize/seo.mdx | 29 +++++++++++++++++++++++++++++
optimize/seo.mdx | 29 +++++++++++++++++++++++++++++
zh/optimize/seo.mdx | 29 +++++++++++++++++++++++++++++
4 files changed, 116 insertions(+)
diff --git a/es/optimize/seo.mdx b/es/optimize/seo.mdx
index e98c372ffa..3896e06669 100644
--- a/es/optimize/seo.mdx
+++ b/es/optimize/seo.mdx
@@ -410,6 +410,35 @@ También puedes especificar `noindex` para todas las páginas de tu documentaci
}
```
+### Desactivar la indexación de todo el proyecto
+
+Para ocultar todo tu despliegue de los motores de búsqueda manteniéndolo públicamente accesible, activa **Don't index project** en tu panel, en **Settings > Deployment > Add-ons > Visibility**.
+
+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`.
+- Borra tu índice de búsqueda para que las páginas dejen de aparecer en la búsqueda interna, el [Asistente de IA](/es/assistant/index) o el [servidor MCP](/es/ai/model-context-protocol).
+- Sirve un `robots.txt` que bloquea todo el sitio:
+
+ ```txt
+ User-agent: *
+ Content-Signal: ai-train=no, search=no, ai-input=no
+ Disallow: /
+ ```
+
+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.
+
+
+ Cambiar este ajuste desencadena un redespliegue de tu sitio. Los cambios surten efecto una vez completado el redespliegue.
+
+
+Esta opción funciona junto con otros controles de indexación:
+
+- **`noindex` por página** — Los ajustes `noindex: true` en el frontmatter de una página siguen aplicándose cuando la opción a nivel de proyecto está desactivada. La opción a nivel de proyecto anula los ajustes por página cuando está activada, por lo que todas las páginas se tratan como `noindex`.
+- **`robots.txt` personalizado** — Si tienes un [`robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto, Mintlify lo sirve sin modificaciones. La opción a nivel de proyecto no reemplaza un `robots.txt` personalizado, así que actualiza o elimina tu archivo personalizado por separado si necesitas que las reglas para rastreadores coincidan.
+
## Mejores prácticas de SEO
diff --git a/fr/optimize/seo.mdx b/fr/optimize/seo.mdx
index ec01fd83f4..a51bb2c2b0 100644
--- a/fr/optimize/seo.mdx
+++ b/fr/optimize/seo.mdx
@@ -411,6 +411,35 @@ Vous pouvez également définir `noindex` pour toutes les pages de votre documen
}
```
+### Désactiver l’indexation pour l’ensemble du projet
+
+Pour masquer l’intégralité de votre déploiement aux moteurs de recherche tout en le maintenant accessible publiquement, activez **Don't index project** dans votre tableau de bord, sous **Settings > Deployment > Add-ons > Visibility**.
+
+Lorsqu’il est activé, Mintlify :
+
+- Rend chaque page avec les balises meta robots `noindex, nofollow`.
+- Renvoie un `sitemap.xml` vide.
+- Renvoie `404` pour `llms.txt` et `llms-full.txt`.
+- Vide votre index de recherche, de sorte que les pages n’apparaissent plus dans la recherche interne, l’[assistant IA](/fr/assistant/index) ni le [serveur MCP](/fr/ai/model-context-protocol).
+- Sert un `robots.txt` qui interdit l’accès à tout le site :
+
+ ```txt
+ User-agent: *
+ Content-Signal: ai-train=no, search=no, ai-input=no
+ Disallow: /
+ ```
+
+Utilisez cette option lorsque vous souhaitez conserver un déploiement en ligne pour une relecture interne, une mise en préproduction ou un partage limité, sans qu’il apparaisse dans les résultats de recherche publics ni qu’il soit utilisé comme données d’entraînement ou de récupération pour les outils d’IA.
+
+
+ Modifier ce paramètre déclenche un redéploiement de votre site. Les changements prennent effet une fois le redéploiement terminé.
+
+
+Ce paramètre fonctionne en complément d’autres contrôles d’indexation :
+
+- **`noindex` par page** — Le `noindex: true` au niveau d’une page dans le frontmatter continue de s’appliquer lorsque le paramètre au niveau du projet est désactivé. Le paramètre au niveau du projet remplace les réglages par page lorsqu’il est activé, et toutes les pages sont alors traitées comme `noindex`.
+- **`robots.txt` personnalisé** — Si vous avez un [`robots.txt` personnalisé](#custom-sitemaps-and-robotstxt-files) à la racine de votre projet, Mintlify le sert tel quel. Le paramètre au niveau du projet ne remplace pas un `robots.txt` personnalisé : mettez-le à jour ou supprimez-le séparément si vous souhaitez que les règles pour les robots d’exploration soient cohérentes.
+
## Bonnes pratiques SEO
diff --git a/optimize/seo.mdx b/optimize/seo.mdx
index f3e0b76e7e..fc5497a863 100644
--- a/optimize/seo.mdx
+++ b/optimize/seo.mdx
@@ -388,6 +388,35 @@ You can also specify `noindex` for all pages in your docs by setting the `metata
}
```
+### Disable indexing for the entire project
+
+To hide your entire deployment from search engines while keeping it publicly accessible, enable **Don't index project** in your dashboard under **Settings > Deployment > Add-ons > Visibility**.
+
+When enabled, Mintlify:
+
+- Renders every page with `noindex, nofollow` robots meta tags.
+- Returns an empty `sitemap.xml`.
+- Returns `404` for `llms.txt` and `llms-full.txt`.
+- Clears your search index so pages no longer appear in internal search, the [AI assistant](/assistant/index), or the [MCP server](/ai/model-context-protocol).
+- Serves a site-wide disallow `robots.txt`:
+
+ ```txt
+ User-agent: *
+ Content-Signal: ai-train=no, search=no, ai-input=no
+ Disallow: /
+ ```
+
+Use this when you want to keep a deployment online for internal review, staging, or limited sharing, but do not want it to appear in public search results or be used as training or retrieval data for AI tools.
+
+
+ Toggling this setting triggers a redeployment of your site. Changes take effect after the redeployment completes.
+
+
+This setting works alongside other indexing controls:
+
+- **Per-page `noindex`** — Page-level `noindex: true` in frontmatter continues to apply when the project-level setting is off. The project-level setting overrides per-page settings when enabled, so every page is treated as `noindex`.
+- **Custom `robots.txt`** — If you have a [custom `robots.txt`](#custom-sitemaps-and-robotstxt-files) at the root of your project, Mintlify serves it unchanged. The project-level setting does not replace a custom `robots.txt`, so update or remove your custom file separately if you need crawler rules to match.
+
## SEO best practices
diff --git a/zh/optimize/seo.mdx b/zh/optimize/seo.mdx
index 88fca6b942..5b0709b54b 100644
--- a/zh/optimize/seo.mdx
+++ b/zh/optimize/seo.mdx
@@ -408,6 +408,35 @@ noindex: true
}
```
+### 为整个项目禁用索引编入
+
+要在保持文档公开可访问的同时让搜索引擎不收录整个部署，请在仪表盘的 **Settings > Deployment > Add-ons > Visibility** 下启用 **Don't index project**。
+
+启用后，Mintlify 会：
+
+- 为每个页面渲染 `noindex, nofollow` 的 robots meta 标签。
+- 返回空的 `sitemap.xml`。
+- 对 `llms.txt` 和 `llms-full.txt` 返回 `404`。
+- 清空搜索索引，使页面不再出现在内部搜索、[AI 助手](/zh/assistant/index)或 [MCP 服务器](/zh/ai/model-context-protocol)中。
+- 提供一个对整个站点禁止访问的 `robots.txt`：
+
+ ```txt
+ User-agent: *
+ Content-Signal: ai-train=no, search=no, ai-input=no
+ Disallow: /
+ ```
+
+当你希望保持部署在线以便内部审阅、预演或有限分享，但不希望它出现在公开搜索结果中，或被 AI 工具用作训练或检索数据时，可以使用此选项。
+
+
+ 切换此设置会触发站点重新部署。更改将在重新部署完成后生效。
+
+
+此设置与其他索引控制配合使用：
+
+- **按页 `noindex`** — 当项目级设置关闭时，frontmatter 中的 `noindex: true` 仍然生效。项目级设置开启时会覆盖按页设置，所有页面都按 `noindex` 处理。
+- **自定义 `robots.txt`** — 如果你在项目根目录提供了[自定义 `robots.txt`](#custom-sitemaps-and-robotstxt-files)，Mintlify 会原样提供该文件。项目级设置不会替换自定义 `robots.txt`，因此如果需要让爬虫规则保持一致，请单独更新或删除你的自定义文件。
+
## SEO 最佳实践
From a9c27520cf6ed47079b75e26c85dfe198a0f2132 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:16:52 +0000
Subject: [PATCH 2/3] docs: wrap translated noindex headings with anchor divs
---
es/optimize/seo.mdx | 4 +++-
fr/optimize/seo.mdx | 4 +++-
zh/optimize/seo.mdx | 4 +++-
3 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/es/optimize/seo.mdx b/es/optimize/seo.mdx
index 3896e06669..e534062930 100644
--- a/es/optimize/seo.mdx
+++ b/es/optimize/seo.mdx
@@ -410,7 +410,9 @@ También puedes especificar `noindex` para todas las páginas de tu documentaci
}
```
-### Desactivar la indexación de todo el proyecto
+
+ ### Desactivar la indexación de todo el proyecto
+
Para ocultar todo tu despliegue de los motores de búsqueda manteniéndolo públicamente accesible, activa **Don't index project** en tu panel, en **Settings > Deployment > Add-ons > Visibility**.
diff --git a/fr/optimize/seo.mdx b/fr/optimize/seo.mdx
index a51bb2c2b0..22b1e47ea8 100644
--- a/fr/optimize/seo.mdx
+++ b/fr/optimize/seo.mdx
@@ -411,7 +411,9 @@ Vous pouvez également définir `noindex` pour toutes les pages de votre documen
}
```
-### Désactiver l’indexation pour l’ensemble du projet
+
+ ### Désactiver l’indexation pour l’ensemble du projet
+
Pour masquer l’intégralité de votre déploiement aux moteurs de recherche tout en le maintenant accessible publiquement, activez **Don't index project** dans votre tableau de bord, sous **Settings > Deployment > Add-ons > Visibility**.
diff --git a/zh/optimize/seo.mdx b/zh/optimize/seo.mdx
index 5b0709b54b..27ce48695f 100644
--- a/zh/optimize/seo.mdx
+++ b/zh/optimize/seo.mdx
@@ -408,7 +408,9 @@ noindex: true
}
```
-### 为整个项目禁用索引编入
+
+ ### 为整个项目禁用索引编入
+
要在保持文档公开可访问的同时让搜索引擎不收录整个部署，请在仪表盘的 **Settings > Deployment > Add-ons > Visibility** 下启用 **Don't index project**。
From 5e72cab24bc6257998d638a0573e29fb672c0066 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Thu, 11 Jun 2026 11:28:47 -0700
Subject: [PATCH 3/3] Apply suggestions from code review
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
---
optimize/seo.mdx | 20 ++++++++------------
1 file changed, 8 insertions(+), 12 deletions(-)
diff --git a/optimize/seo.mdx b/optimize/seo.mdx
index fc5497a863..8ebc5f592a 100644
--- a/optimize/seo.mdx
+++ b/optimize/seo.mdx
@@ -390,32 +390,28 @@ You can also specify `noindex` for all pages in your docs by setting the `metata
### Disable indexing for the entire project
-To hide your entire deployment from search engines while keeping it publicly accessible, enable **Don't index project** in your dashboard under **Settings > Deployment > Add-ons > Visibility**.
+To hide your entire deployment from search engines while keeping it publicly accessible, enable **Don't index project** on the [Add-ons](https://app.mintlify.com/settings/deployment/addons) page of your dashboard.
-When enabled, Mintlify:
+When enabled, your site:
- Renders every page with `noindex, nofollow` robots meta tags.
- Returns an empty `sitemap.xml`.
- Returns `404` for `llms.txt` and `llms-full.txt`.
-- Clears your search index so pages no longer appear in internal search, the [AI assistant](/assistant/index), or the [MCP server](/ai/model-context-protocol).
+- Clears your search index so pages no longer appear in internal search, the [assistant](/assistant/index), or your [search MCP server](/ai/model-context-protocol).
- Serves a site-wide disallow `robots.txt`:
- ```txt
- User-agent: *
- Content-Signal: ai-train=no, search=no, ai-input=no
- Disallow: /
- ```
+
-Use this when you want to keep a deployment online for internal review, staging, or limited sharing, but do not want it to appear in public search results or be used as training or retrieval data for AI tools.
+Disable indexing when you want to keep a deployment online for internal review, staging, or limited sharing, but do not want it to appear in public search results or for AI tools to use it as training or retrieval data.
- Toggling this setting triggers a redeployment of your site. Changes take effect after the redeployment completes.
+ Enabling or disabling indexing redeploys your site. Changes to indexing take effect after the redeployment completes.
This setting works alongside other indexing controls:
-- **Per-page `noindex`** — Page-level `noindex: true` in frontmatter continues to apply when the project-level setting is off. The project-level setting overrides per-page settings when enabled, so every page is treated as `noindex`.
-- **Custom `robots.txt`** — If you have a [custom `robots.txt`](#custom-sitemaps-and-robotstxt-files) at the root of your project, Mintlify serves it unchanged. The project-level setting does not replace a custom `robots.txt`, so update or remove your custom file separately if you need crawler rules to match.
+- **Per-page `noindex`**: Page-level `noindex: true` in frontmatter continues to apply when the project-level setting is off. Project-level settings override per-page settings when enabled.
+- **Custom `robots.txt`**: If you have a [custom `robots.txt`](#custom-sitemaps-and-robotstxt-files) at the root of your project, Mintlify serves it unchanged. Project-level settings do not replace custom `robots.txt` files, so you must update or remove custom files for crawler rules to match.
## SEO best practices