mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
355de73f7b
* Clarify seo.indexing override in hidden pages callout Generated-By: mintlify-agent * Clarify hidden page indexing behavior Mintlify-Source: dashboard-editor --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Dean from Mintlify <dean@mintlify.com>
110 lines
3.9 KiB
Plaintext
110 lines
3.9 KiB
Plaintext
---
|
|
title: "Hidden pages"
|
|
description: "Hide documentation pages from the sidebar navigation while keeping them accessible via direct URL, search, or AI assistant for special use cases."
|
|
keywords: ["hide from navigation", "unlisted", "page visibility"]
|
|
---
|
|
|
|
Hidden pages don't appear in your site's navigation, but anyone who knows the URL can still access them. For example, if you create a hidden page like `guides/hidden-page.mdx`, visitors can reach it at `docs.yoursite.com/guides/hidden-page`.
|
|
|
|
Use hidden pages for content you want users to access or reference as context for AI tools, but don't want listed in the navigation.
|
|
|
|
If your content requires strict access control, you must configure [authentication](/deploy/authentication-setup).
|
|
|
|
To restrict pages to specific user groups, set up [group-based access control](/deploy/authentication-setup#control-access-with-groups).
|
|
|
|
See an [example of a hidden page](/organize/hidden-page-example).
|
|
|
|
<Note>
|
|
Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages.
|
|
</Note>
|
|
|
|
## Hide a page
|
|
|
|
To hide a page, set `hidden: true` in the page's [frontmatter](/organize/pages) or remove it from your `docs.json` navigation.
|
|
|
|
### Set `hidden: true` in frontmatter
|
|
|
|
Add `hidden: true` to a page's frontmatter to remove it from the rendered navigation while still including it in your `docs.json` configuration.
|
|
|
|
```yaml
|
|
---
|
|
title: "My hidden page"
|
|
hidden: true
|
|
---
|
|
```
|
|
|
|
To make a page visible again, remove the `hidden` field entirely. Do not set `hidden: false` as it results in undefined behavior.
|
|
|
|
<Note>
|
|
By default, `hidden: true` excludes a page from search engine indexing, sitemaps, and AI context.
|
|
|
|
To include it anyway, set `seo.indexing: "all"` in `docs.json`. See [Search, SEO, and AI indexing](https://www.mintlify.com/docs/#search-seo-and-ai-indexing) for details.
|
|
|
|
Note: `noindex: true` only affects indexing - it does not hide the page from navigation. See [Disable indexing](https://www.mintlify.com/docs/optimize/seo#disable-indexing) for more information.
|
|
</Note>
|
|
|
|
### Remove the page from navigation
|
|
|
|
If you don't include a page in your `docs.json` navigation, you hide it. This method works well for pages that you don't want to appear in navigation at all.
|
|
|
|
## Hide a group of pages
|
|
|
|
To hide a group of pages, set the `hidden` property to `true` for the group in your `docs.json` file:
|
|
|
|
```json highlight={4}
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"hidden": true,
|
|
"pages": [
|
|
"index",
|
|
"quickstart"
|
|
]
|
|
},
|
|
{
|
|
"group": "Guides",
|
|
"pages": [
|
|
"guides/hidden-page.mdx",
|
|
"guides/hidden-groups.mdx"
|
|
]
|
|
}
|
|
]
|
|
```
|
|
|
|
In this example, the `Getting started` group is hidden and the `Guides` group is visible.
|
|
|
|
### Hide a tab
|
|
|
|
To hide a tab, add the `hidden` property for the tab in your `docs.json` file:
|
|
|
|
```json highlight={4}
|
|
"tabs": [
|
|
{
|
|
"tab": "Home",
|
|
"hidden": true,
|
|
"pages": [
|
|
"index",
|
|
"quickstart"
|
|
]
|
|
}
|
|
]
|
|
```
|
|
|
|
## 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`:
|
|
|
|
```json
|
|
"seo": {
|
|
"indexing": "all"
|
|
}
|
|
```
|
|
|
|
### Understanding hidden versus noindex
|
|
|
|
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.
|
|
|
|
To exclude a specific page from search engines while keeping it visible in navigation, add `noindex: true` to its frontmatter. To hide a page from navigation and search engines, use `hidden: true`. |