Every page's behaviour is controlled by its frontmatter.
Page settings is that frontmatter as a form: open it on any page in the editor
and each field maps to a frontmatter key, saved back into the page's own
.mdx file — so what you set here is exactly what a teammate sees at the top
of the file in Git.
The fields
| Field | Frontmatter key | What it does |
| Title | title | The page heading, browser tab and search result title |
| Slug | — | The page's URL path |
| External URL | href | Makes the nav entry an outbound link instead of a page |
| Description | description | Subtitle under the title, meta description, and what search snippets quote |
| Icon | icon | Sidebar icon — a Lucide name like rocket |
| Sidebar title | sidebarTitle | Shorter label for the sidebar when the real title runs long |
| OG Image URL | og:image | Social-share card image; auto-generated when empty |
| Tag | tag | Small badge next to the sidebar entry — "New", "Beta" |
| Hidden | hidden | Keeps the page out of the sidebar while its URL still resolves |
| Keywords | keywords | Extra search terms the page should match |
| Mode | mode | Layout mode — default, center, wide, custom |
The form writes ordinary frontmatter, nothing panel-specific. A page configured here can be edited as YAML tomorrow — by a person or by an agent over MCP — and the panel will show whatever the file says.
Slug changes are moves
Changing the slug moves the page: the old file is deleted and the content is
committed under the new path — two commits, both visible in your Git history.
Links elsewhere in your docs that
pointed at the old path don't update themselves — add a
redirect for the old URL, and if you author over MCP,
validate_mdx will flag any internal link left pointing at the old path.
Hidden vs private
Two switches, different jobs:
Hidden (
hidden: true) — out of the sidebar, still reachable by URL and still served to search engines and agents. Use for pages you link to directly.Private (
private: true, set in frontmatter) — access-controlled: gone from search, listings, LLM exports and MCP alike. Use for pages that genuinely aren't public.