Frontmatter
Learn about configuring your documentation pages with frontmatter.
Frontmatter is a way to customize metadata of a page directly within your Markdown files. The metadata properties can be added to Markdown pages by adding frontmatter blocks to the top of any page.
---
title: Welcome to Awesome Project
description: Some awesome docs!
---
# Welcome!
Frontmatter overrides any default properties set in the project configuration file. This allows you to customize each page with unique metadata.
Properties
Below is a list of all available frontmatter properties, their type and default values.
title
string
The title of the page used in metadata, and social cards and as a page heading title.
description
string
The description of the page used in metadata.
image
string
An Asset URL to an image used in social cards and shown at the top of the page if showPageImage
is true
.
redirect
string
A URL to redirect to when the page is visited. Setting this value overrides the page content.
showPageTitle
boolean
Whether to show the title
as a heading title at the top of the page.
showPageImage
boolean
Whether to show the image
at the top of the page.
noindex
boolean
If true, the page will be excluded from search engines.
previous
string
A path which if set, will show a link to the previous page at the bottom of the page.
Use with previousTitle
:
---
previous: /getting-started
previousTitle: Getting started
---
next
string
A path which if set, will show a link to the next page at the bottom of the page.
Use with nextTitle
:
---
next: /getting-started
nextTitle: Getting started
---