Configure directory-level sidebar navigation with .config.yml.
Directory Navigation
Beyond per-file frontmatter, you can place a .config.yml file in any content directory to configure the whole directory.
Directory-level navigation
# content/docs/guide/.config.yml
navigation:
label: Guide
icon: book
description: A collection of how-to guides| Field | Type | Description |
|---|---|---|
navigation.title | string | The directory's group title in the sidebar. |
navigation.label | string | An alternative label. |
navigation.description | string | Group description. |
navigation.icon | string | Icon identifier (interpreted by your nav component). |
navigation.hidden | boolean | Hide the whole directory group, including its children. |
navigation.flatten | boolean | Promote children to the parent level, removing this grouping layer. |
hidden: hide a group
navigation:
hidden: trueThe directory disappears from the sidebar, but pages inside it remain accessible by URL.
flatten: collapse a level
navigation:
flatten: trueChild pages are promoted one level up, removing the "group → children" two-level structure — handy when you don't want an extra layer of nesting.