Frontmatter
Set page titles, descriptions and visibility using frontmatter.
Frontmatter is the YAML block at the beginning of a page. It describes the page for navigation, search and the rendered heading.
---
title: Quickstart
description: Create and publish your first project.
---
## Before you begin
Prepare the information needed for setup.Common fields
| Field | Use |
|---|---|
title | Page heading and navigation title |
description | A concise explanation of the page |
icon | Optional supported icon name |
draft: true | Exclude the page from public content |
unlisted: true | Exclude the page from the public content pipeline |
Use boolean values for visibility fields, not quoted strings. Quote descriptions containing colons or other YAML punctuation. Avoid repeating the title as an H1 in the body.
Navigation and URLs
Current sites use file paths for page URLs and meta.json for navigation order. A frontmatter title change does not rename the file. Do not rely on old sidebar_position or slug conventions when editing a current site.
Public content
Publish after changing a page's visibility. Hiding a link is not a privacy boundary, and public docs are not a place to upload secrets. Older projects may use different fields; preserve their existing format.