docs: document searchable opt-in for hidden tabs and groups

es/organize/hidden-pages.mdx

@@ -100,6 +100,50 @@ Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `do
 ]
 ```
 
+<div id="keep-hidden-tabs-and-groups-searchable">
+  ## Mantener las tabs y grupos ocultos como buscables
+</div>
+
+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.
+
 <div id="search-seo-and-ai-indexing">
   ## Búsqueda, SEO e indexación de IA
 </div>

fr/organize/hidden-pages.mdx

@@ -100,6 +100,50 @@ Pour masquer un onglet, ajoutez la propriété `hidden` pour l’onglet dans vot
 ]
 ```
 
+<div id="keep-hidden-tabs-and-groups-searchable">
+  ## Garder les onglets et groupes masqués indexables
+</div>
+
+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.
+
 <div id="search-seo-and-ai-indexing">
   ## Recherche, SEO et indexation par l’IA
 </div>

organize/hidden-pages.mdx

@@ -71,7 +71,7 @@
 ]
 ```
 
 In this example, the `Getting started` group is hidden and the `Guides` group is visible.
 
 ### Hide a tab
 
@@ -90,6 +90,48 @@
 ]
 ```
 
+## 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`:
@@ -105,5 +147,5 @@
 The relationship between `hidden` and `noindex` is one-directional:
 
 - **`hidden: true` → automatically applies `noindex`**: Hidden pages are automatically excluded from search engines, sitemaps, and AI context.
 - **`noindex: true` → does NOT apply `hidden`**: Pages with `noindex: true` remain visible in navigation. They only affect search engine indexing and AI context.
 

zh/organize/hidden-pages.mdx

@@ -100,6 +100,50 @@ hidden: true
 ]
 ```
 
+<div id="keep-hidden-tabs-and-groups-searchable">
+  ## 让隐藏的标签页和分组保持可搜索
+</div>
+
+默认情况下，隐藏标签页或分组下的每个页面都会从搜索、站点地图、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` 始终优先，无论祖先节点如何设置。
+
 <div id="search-seo-and-ai-indexing">
   ## 搜索、SEO 与 AI 索引编入
 </div>