docs: document searchable for hidden tabs and groups

optimize/seo.mdx

@@ -309,6 +309,8 @@ To include hidden pages in search indexing, add `seo.indexing` to your `docs.jso
 }
 ```
 
+To include only the pages under a specific hidden tab or group, set `searchable: true` on that tab or group. See [Search, SEO, and AI indexing](/organize/hidden-pages#search-seo-and-ai-indexing) for details.
+
 <Note>
   For documentation sites that require authentication, sitemaps and `robots.txt` files also require authenticating to access. Sitemaps exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups).
 </Note>

organize/hidden-pages.mdx

@@ -92,14 +92,50 @@ To hide a tab, add the `hidden` property for the tab in your `docs.json` file:
 
 ## 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`:
+By default, hidden pages don't appear in indexing for search engines, documentation site search, or as AI assistant context. You have two ways to include hidden content in search and indexing.
+
+### Include all hidden pages
+
+To include every hidden page across your site in search, sitemaps, and AI context, add the `seo` property to your `docs.json`:
 
 ```json
 "seo": {
     "indexing": "all"
 }
 ```
 
+### Include pages under specific hidden tabs or groups
+
+To include only the pages under a specific hidden tab or group, set `searchable: true` on that tab or group in your `docs.json`. Use this option when you hide tabs or groups to control navigation layout but still want descendant pages discoverable.
+
+```json highlight={5}
+"tabs": [
+  {
+    "tab": "Storage",
+    "hidden": true,
+    "searchable": true,
+    "groups": [
+      {
+        "group": "Buckets",
+        "pages": ["products/storage/buckets/create-bucket"]
+      }
+    ]
+  }
+]
+```
+
+With `searchable: true`, descendant pages remain in:
+
+- Documentation site search
+- `sitemap.xml`
+- AI assistant context
+- MCP server search results
+- Search engine indexing (the `noindex` meta tag is not applied)
+
+The tab or group itself stays hidden from the rendered navigation.
+
+A page's own `hidden: true` frontmatter always takes precedence. To re-exclude a descendant group, set `hidden: true` on it without `searchable: true`.
+
 ### Understanding hidden versus noindex
 
 The relationship between `hidden` and `noindex` is one-directional: