Skip to content

Document per-page hide-header-tabs frontmatter #6729

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
devin-ai-integration wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Document per-page hide-header-tabs frontmatter #6729

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
470ac6c
Document per-page disable-header and hide-header-tabs frontmatter
devin-ai-integration[bot] Aug 24, 2026
af5a19b
docs: link page header options to specific settings
devalog Aug 25, 2026
9ad4c78
Document only per-page hide-header-tabs frontmatter
devin-ai-integration[bot] Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions fern/products/docs/pages/navigation/frontmatter.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -280,6 +280,21 @@ hide-page-actions: true
```
</CodeBlock>

## Header
<ParamField path="hide-header-tabs" type="boolean" required={false} default={false}>
Hides the tabs row on this page, keeping the header bar (logo, search, and navbar links). Useful for a custom landing page that supplies its own navigation. Applies only when [`layout.tabs-placement`](/learn/docs/configuration/site-level-settings#layouttabs-placement) or [`theme.tabs.placement`](/learn/docs/configuration/site-level-settings#themetabsplacement) is `header`.
</ParamField>

<CodeBlock title="landing-page.mdx">
```mdx
---
title: Landing Page
layout: custom
hide-header-tabs: true
---
```
</CodeBlock>

## Page logo
<ParamField path="logo" type="object" required={false}>
Override the site-wide logo for a page. Specify different logos for light and dark modes using absolute URLs.
Expand Down
2 changes: 2 additions & 0 deletions fern/products/docs/pages/navigation/site-level-settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -614,6 +614,8 @@ layout:
<ParamField path="layout.tabs-placement" type="string" required={false} default="sidebar" toc={true}>
Set the placement of the tabs. Can be one of `header` or `sidebar`.

With `header`, individual pages can hide the tabs row using the [`hide-header-tabs` frontmatter](/learn/docs/configuration/page-level-settings#header), which suits a custom landing page that supplies its own navigation.

<Note>This setting is ignored when `disable-header` is set to true.</Note>
</ParamField>

Expand Down
Loading