NavConfig

Page data is defined in the config's navConfig field. Properties for this field are documented here.

WARNING

Several of these properties overlap with properties on the page's Frontmatter. Properties defined on the NavConfig take precedence over properties defined on each page's Frontmatter.

The NavConfig type is a union of two types:

export type NavConfig = RouteMeta | NavMeta

API

RouteMeta

Metadata that describes a route.

Name & DescriptionOption(s)Default
The path segment for this route.
string
Nested routes.
RouteMeta[]
If true, the side nav item will be expanded on initial load. Does nothing if the entry is a leaf node.
boolean
If true, this route will not be shown in the side navigation or adjacent routes' page links.
boolean
If true, the breadcrumbs will not render on this route.
boolean
If true, this page's contents will not be added to the search index.
boolean
If true, the page links will be hidden on this route.
boolean
If true, the side navigation will be hidden on this route.
boolean
If true, the table of contents be hidden on this route.
boolean
By default, pages with a RouteMeta are ordered before pages that are not defined. Set this property to true to disable that behavior.
boolean
false
If true, the route will be flagged as restricted. This flag does nothing internally. You will need to handle this in your application.
boolean
Title for the page in the side nav. Takes precedence over title.
string
The title of the item in the side nav. Will be parsed from the page's frontmatter if it is not defined in the RouteMeta.
string
Type
string
Description
The path segment for this route.
Description
Nested routes.
Type
boolean
Description
If true, the side nav item will be expanded on initial load. Does nothing if the entry is a leaf node.
Type
boolean
Description
If true, this route will not be shown in the side navigation or adjacent routes' page links.
Type
boolean
Description
If true, the breadcrumbs will not render on this route.
Type
boolean
Description
If true, this page's contents will not be added to the search index.
Type
boolean
Description
If true, the page links will be hidden on this route.
Type
boolean
Description
If true, the side navigation will be hidden on this route.
Type
boolean
Description
If true, the table of contents be hidden on this route.
Type
boolean
Default
false
Description
By default, pages with a RouteMeta are ordered before pages that are not defined. Set this property to true to disable that behavior.
Type
boolean
Description
If true, the route will be flagged as restricted. This flag does nothing internally. You will need to handle this in your application.
Type
string
Description
Title for the page in the side nav. Takes precedence over title.
Type
string
Description
The title of the item in the side nav. Will be parsed from the page's frontmatter if it is not defined in the RouteMeta.

Metadata describing a nav item without an associated route. These entries are used to render separators or section titles between other nav items.

Note that this is currently limited to top-level nav items (not supported in children).

Name & DescriptionOption(s)Default
A label that describes a group of nav items.
string
Render a horizontal separator.
boolean
Type
string
Description
A label that describes a group of nav items.
Type
boolean
Description
Render a horizontal separator.