From ec114eed711c3ba3d78f2b42729ae8a31b398b97 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 16 May 2026 16:55:11 +0000
Subject: [PATCH 1/2] docs: document searchable opt-in for hidden tabs and
groups
---
es/organize/hidden-pages.mdx | 42 ++++++++++++++++++++++++++++++++++++
fr/organize/hidden-pages.mdx | 42 ++++++++++++++++++++++++++++++++++++
organize/hidden-pages.mdx | 42 ++++++++++++++++++++++++++++++++++++
zh/organize/hidden-pages.mdx | 42 ++++++++++++++++++++++++++++++++++++
4 files changed, 168 insertions(+)
diff --git a/es/organize/hidden-pages.mdx b/es/organize/hidden-pages.mdx
index cf8c8665e5..1e226d55c4 100644
--- a/es/organize/hidden-pages.mdx
+++ b/es/organize/hidden-pages.mdx
@@ -100,6 +100,48 @@ Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `do
]
```
+## Mantener las tabs y grupos ocultos como buscables
+
+De forma predeterminada, cada página dentro de una tab o un grupo oculto también queda excluida de la búsqueda, el sitemap, el assistant de IA, `llms.txt`, `skill.md` y la indexación en motores de búsqueda. Para mantener esas superficies de descubrimiento funcionando mientras la tab o el grupo permanece fuera de la navegación visible, establece `searchable: true` junto con `hidden: true`.
+
+Usa esto cuando ocultas intencionalmente una tab o un grupo de la barra lateral, por ejemplo, para aislar una navegación lateral por producto, pero aún quieres que las páginas subyacentes se puedan encontrar.
+
+```json docs.json highlight={4-5}
+"tabs": [
+ {
+ "tab": "Product A",
+ "hidden": true,
+ "searchable": true,
+ "groups": [
+ {
+ "group": "Guides",
+ "pages": ["product-a/index", "product-a/quickstart"]
+ }
+ ]
+ }
+]
+```
+
+La misma propiedad funciona en los grupos:
+
+```json docs.json highlight={4-5}
+"groups": [
+ {
+ "group": "Internal guides",
+ "hidden": true,
+ "searchable": true,
+ "pages": ["internal/index", "internal/setup"]
+ }
+]
+```
+
+Cómo interactúa `searchable` con `hidden` mientras Mintlify recorre el árbol de navegación:
+
+- Un nodo con `hidden: true` excluye todas las páginas descendientes de las superficies de descubrimiento.
+- Un nodo con `hidden: true` y `searchable: true` vuelve a exponer a sus descendientes hasta que otro descendiente establezca `hidden: true` (sin `searchable: true`), lo que vuelve a excluir ese subárbol.
+- `searchable: true` en una tab o grupo que no está oculto no tiene efecto.
+- `hidden: true` en el propio frontmatter de una página siempre prevalece, sin importar la configuración de los ancestros.
+
## Búsqueda, SEO e indexación de IA
diff --git a/fr/organize/hidden-pages.mdx b/fr/organize/hidden-pages.mdx
index beba02945c..5cce4aebb9 100644
--- a/fr/organize/hidden-pages.mdx
+++ b/fr/organize/hidden-pages.mdx
@@ -100,6 +100,48 @@ Pour masquer un onglet, ajoutez la propriété `hidden` pour l’onglet dans vot
]
```
+## Garder les onglets et groupes masqués indexables
+
+Par défaut, chaque page sous un onglet ou un groupe masqué est également exclue de la recherche, du sitemap, de l’Assistant IA, de `llms.txt`, de `skill.md` et de l’indexation par les moteurs de recherche. Pour que ces surfaces de découverte restent fonctionnelles tandis que l’onglet ou le groupe reste hors de la navigation affichée, définissez `searchable: true` en plus de `hidden: true`.
+
+Utilisez cette option lorsque vous masquez intentionnellement un onglet ou un groupe de la barre latérale — par exemple, pour isoler une navigation latérale par produit — mais que vous souhaitez toujours que les pages sous-jacentes soient trouvables.
+
+```json docs.json highlight={4-5}
+"tabs": [
+ {
+ "tab": "Product A",
+ "hidden": true,
+ "searchable": true,
+ "groups": [
+ {
+ "group": "Guides",
+ "pages": ["product-a/index", "product-a/quickstart"]
+ }
+ ]
+ }
+]
+```
+
+La même propriété fonctionne sur les groupes :
+
+```json docs.json highlight={4-5}
+"groups": [
+ {
+ "group": "Internal guides",
+ "hidden": true,
+ "searchable": true,
+ "pages": ["internal/index", "internal/setup"]
+ }
+]
+```
+
+Comment `searchable` interagit avec `hidden` lorsque Mintlify parcourt l’arbre de navigation :
+
+- Un nœud avec `hidden: true` exclut toutes les pages descendantes des surfaces de découverte.
+- Un nœud avec `hidden: true` et `searchable: true` réexpose ses descendants jusqu’à ce qu’un autre descendant définisse `hidden: true` (sans `searchable: true`), ce qui exclut de nouveau ce sous-arbre.
+- `searchable: true` sur un onglet ou un groupe qui n’est pas masqué n’a aucun effet.
+- `hidden: true` dans le frontmatter d’une page l’emporte toujours, quelle que soit la configuration des ancêtres.
+
## Recherche, SEO et indexation par l’IA
diff --git a/organize/hidden-pages.mdx b/organize/hidden-pages.mdx
index 3d2284cfde..85c25604ec 100644
--- a/organize/hidden-pages.mdx
+++ b/organize/hidden-pages.mdx
@@ -90,6 +90,48 @@ To hide a tab, add the `hidden` property for the tab in your `docs.json` file:
]
```
+## Keep hidden tabs and groups searchable
+
+By default, every page under a hidden tab or group is also excluded from search, the sitemap, the AI assistant, `llms.txt`, `skill.md`, and search engine indexing. To keep those discovery surfaces working while the tab or group stays out of the rendered navigation, set `searchable: true` alongside `hidden: true`.
+
+Use this when you intentionally hide a tab or group from the sidebar—for example, to isolate a per-product left navigation—but you still want the underlying pages to be findable.
+
+```json docs.json highlight={4-5}
+"tabs": [
+ {
+ "tab": "Product A",
+ "hidden": true,
+ "searchable": true,
+ "groups": [
+ {
+ "group": "Guides",
+ "pages": ["product-a/index", "product-a/quickstart"]
+ }
+ ]
+ }
+]
+```
+
+The same property works on groups:
+
+```json docs.json highlight={4-5}
+"groups": [
+ {
+ "group": "Internal guides",
+ "hidden": true,
+ "searchable": true,
+ "pages": ["internal/index", "internal/setup"]
+ }
+]
+```
+
+How `searchable` interacts with `hidden` as Mintlify walks the navigation tree:
+
+- A node with `hidden: true` excludes all descendant pages from discovery surfaces.
+- A node with `hidden: true` and `searchable: true` re-exposes its descendants until another descendant sets `hidden: true` (without `searchable: true`), which opts that subtree out again.
+- `searchable: true` on a tab or group that is not hidden has no effect.
+- `hidden: true` in a page's own frontmatter always wins, regardless of ancestor settings.
+
## Search, SEO, and AI indexing
By default, hidden pages don't appear in indexing for search engines, documentation site search, or as AI assistant context. To include hidden pages in search results and assistant context, add the `seo` property to your `docs.json`:
diff --git a/zh/organize/hidden-pages.mdx b/zh/organize/hidden-pages.mdx
index df4a4167c4..80b1a2cd54 100644
--- a/zh/organize/hidden-pages.mdx
+++ b/zh/organize/hidden-pages.mdx
@@ -100,6 +100,48 @@ hidden: true
]
```
+## 让隐藏的标签页和分组保持可搜索
+
+默认情况下，隐藏标签页或分组下的每个页面都会从搜索、站点地图、AI 助手、`llms.txt`、`skill.md` 和搜索引擎索引中排除。如果你希望标签页或分组保持隐藏，但仍让这些发现渠道正常工作，请在 `hidden: true` 旁同时设置 `searchable: true`。
+
+当你有意将某个标签页或分组从侧边栏中隐藏，例如为按产品隔离左侧导航，但仍希望底层页面可以被检索到时，可以使用此选项。
+
+```json docs.json highlight={4-5}
+"tabs": [
+ {
+ "tab": "Product A",
+ "hidden": true,
+ "searchable": true,
+ "groups": [
+ {
+ "group": "Guides",
+ "pages": ["product-a/index", "product-a/quickstart"]
+ }
+ ]
+ }
+]
+```
+
+相同的属性也适用于分组：
+
+```json docs.json highlight={4-5}
+"groups": [
+ {
+ "group": "Internal guides",
+ "hidden": true,
+ "searchable": true,
+ "pages": ["internal/index", "internal/setup"]
+ }
+]
+```
+
+Mintlify 在遍历导航树时，`searchable` 与 `hidden` 的交互方式如下：
+
+- 设置了 `hidden: true` 的节点会将其所有后代页面从发现渠道中排除。
+- 同时设置 `hidden: true` 和 `searchable: true` 的节点会重新暴露其后代，直到某个后代设置了 `hidden: true`（且未设置 `searchable: true`），从而再次将该子树排除。
+- 在未隐藏的标签页或分组上设置 `searchable: true` 不会产生任何效果。
+- 页面自身 frontmatter 中的 `hidden: true` 始终优先，无论祖先节点如何设置。
+
## 搜索、SEO 与 AI 索引编入
From 342accfeda0487cdee2a725b9b39cbc7b98b16d1 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 16 May 2026 16:57:21 +0000
Subject: [PATCH 2/2] docs: wrap translated searchable heading in anchor div
---
es/organize/hidden-pages.mdx | 4 +++-
fr/organize/hidden-pages.mdx | 4 +++-
zh/organize/hidden-pages.mdx | 4 +++-
3 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/es/organize/hidden-pages.mdx b/es/organize/hidden-pages.mdx
index 1e226d55c4..9dbc653173 100644
--- a/es/organize/hidden-pages.mdx
+++ b/es/organize/hidden-pages.mdx
@@ -100,7 +100,9 @@ Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `do
]
```
-## Mantener las tabs y grupos ocultos como buscables
+
+ ## Mantener las tabs y grupos ocultos como buscables
+
De forma predeterminada, cada página dentro de una tab o un grupo oculto también queda excluida de la búsqueda, el sitemap, el assistant de IA, `llms.txt`, `skill.md` y la indexación en motores de búsqueda. Para mantener esas superficies de descubrimiento funcionando mientras la tab o el grupo permanece fuera de la navegación visible, establece `searchable: true` junto con `hidden: true`.
diff --git a/fr/organize/hidden-pages.mdx b/fr/organize/hidden-pages.mdx
index 5cce4aebb9..b760222765 100644
--- a/fr/organize/hidden-pages.mdx
+++ b/fr/organize/hidden-pages.mdx
@@ -100,7 +100,9 @@ Pour masquer un onglet, ajoutez la propriété `hidden` pour l’onglet dans vot
]
```
-## Garder les onglets et groupes masqués indexables
+
+ ## Garder les onglets et groupes masqués indexables
+
Par défaut, chaque page sous un onglet ou un groupe masqué est également exclue de la recherche, du sitemap, de l’Assistant IA, de `llms.txt`, de `skill.md` et de l’indexation par les moteurs de recherche. Pour que ces surfaces de découverte restent fonctionnelles tandis que l’onglet ou le groupe reste hors de la navigation affichée, définissez `searchable: true` en plus de `hidden: true`.
diff --git a/zh/organize/hidden-pages.mdx b/zh/organize/hidden-pages.mdx
index 80b1a2cd54..258b4f616e 100644
--- a/zh/organize/hidden-pages.mdx
+++ b/zh/organize/hidden-pages.mdx
@@ -100,7 +100,9 @@ hidden: true
]
```
-## 让隐藏的标签页和分组保持可搜索
+
+ ## 让隐藏的标签页和分组保持可搜索
+
默认情况下，隐藏标签页或分组下的每个页面都会从搜索、站点地图、AI 助手、`llms.txt`、`skill.md` 和搜索引擎索引中排除。如果你希望标签页或分组保持隐藏，但仍让这些发现渠道正常工作，请在 `hidden: true` 旁同时设置 `searchable: true`。