Skip to content

Commit 5bd7749

Browse files
committed
add hidden pages hidden page
1 parent 6779876 commit 5bd7749

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

guides/hidden-pages.mdx

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: "How to add hidden pages"
3+
description: "Exclude pages from your docs.json"
4+
---
5+
6+
Sometimes you may want to write a page and not publish it immediately.
7+
8+
For content that is not strictly confidential, but isn't ready for prime time, you can add pages to your docs without referencing them in your `docs.json`. This is what is considered a "hidden page".
9+
10+
As long as the page is not described under any "group", "tab" or other element in the navigation section of your `docs.json`, the only way a user will be able to navigate to the page is if they know or guess the page URL.
11+
12+
<Note>
13+
Some navigation elements like sidebars and tabs may shift or appear empty on hidden pages
14+
</Note>
15+
16+
If you want to take further steps to hide hidden pages' content, make sure to add `noindex: true` to the frontmatter of your page. This should prevent the page from appearing in external search results. On the other hand, if you do want hidden pages indexed for SEO purposes you can add the following setting to your `docs.json`:
17+
18+
```
19+
"seo" {
20+
"indexing": all
21+
}
22+
```
23+
24+
Learn more about SEO and Sitemaps configuration in the [SEO](https://mintlify.com/docs/settings/seo#sitemaps) docs.
25+
26+
<Warning>
27+
Contents of hidden pages will not be hidden from internal docs search, and may appear in AI-generated results
28+
</Warning>
29+
30+
If you have certain pages that you only want exposed to specific groups of your own users, you may want to use the selective groups access available through [Personalization](https://mintlify.com/docs/settings/authentication-personalization/personalization#showing-hiding-pages).
31+
32+
If you have docs that you want under no circumstances exposed to the wider web, you may want to use [Authentication](https://mintlify.com/docs/settings/authentication-personalization/authentication).

0 commit comments

Comments
 (0)