From 470ac6cadf427aa63850478a88cee1de9d0a6e31 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 24 Aug 2026 14:37:36 +0000 Subject: [PATCH 1/3] Document per-page disable-header and hide-header-tabs frontmatter Co-Authored-By: bot_apk --- .../docs/pages/navigation/frontmatter.mdx | 21 +++++++++++++++++++ .../pages/navigation/site-level-settings.mdx | 2 ++ 2 files changed, 23 insertions(+) diff --git a/fern/products/docs/pages/navigation/frontmatter.mdx b/fern/products/docs/pages/navigation/frontmatter.mdx index d46d355fa5..2c1beff41c 100644 --- a/fern/products/docs/pages/navigation/frontmatter.mdx +++ b/fern/products/docs/pages/navigation/frontmatter.mdx @@ -280,6 +280,27 @@ hide-page-actions: true ``` +## Header + + Hides the site header (logo, search, navbar links, and tabs) on this page. Useful for a custom landing page that supplies its own navigation. + + This can be set globally in the [global configuration](/learn/docs/configuration/site-level-settings#layout-configuration). A page cannot show a header that the global configuration hides. + + + + Hides the tabs row on this page while keeping the header bar itself. Applies only when [`tabs-placement`](/learn/docs/configuration/site-level-settings#layout-configuration) is `header`. + + + +```mdx +--- +title: Landing Page +layout: custom +hide-header-tabs: true +--- +``` + + ## Page logo Override the site-wide logo for a page. Specify different logos for light and dark modes using absolute URLs. diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx index 7869127e8d..f0d9e9ef7c 100644 --- a/fern/products/docs/pages/navigation/site-level-settings.mdx +++ b/fern/products/docs/pages/navigation/site-level-settings.mdx @@ -631,6 +631,8 @@ layout: If set to true, the header won't be rendered. Instead, the logo will be rendered as part of the sidebar, and a 1px border will separate the sidebar from the content. + + Individual pages can hide the header, or only its tabs, using the [frontmatter](/learn/docs/configuration/page-level-settings#header). A page can't show a header that this setting hides. From af5a19b53cc6ab3c43e8946844c028dc3b1951d2 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 25 Aug 2026 20:05:11 +0000 Subject: [PATCH 2/3] docs: link page header options to specific settings Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/navigation/frontmatter.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/products/docs/pages/navigation/frontmatter.mdx b/fern/products/docs/pages/navigation/frontmatter.mdx index 2c1beff41c..22af60d392 100644 --- a/fern/products/docs/pages/navigation/frontmatter.mdx +++ b/fern/products/docs/pages/navigation/frontmatter.mdx @@ -284,11 +284,11 @@ hide-page-actions: true Hides the site header (logo, search, navbar links, and tabs) on this page. Useful for a custom landing page that supplies its own navigation. - This can be set globally in the [global configuration](/learn/docs/configuration/site-level-settings#layout-configuration). A page cannot show a header that the global configuration hides. + To hide the header across the site, set [`layout.disable-header`](/learn/docs/configuration/site-level-settings#layoutdisable-header) in `docs.yml`. A page cannot show a header hidden by this site-level setting. - Hides the tabs row on this page while keeping the header bar itself. Applies only when [`tabs-placement`](/learn/docs/configuration/site-level-settings#layout-configuration) is `header`. + Hides the tabs row on this page while keeping the header bar itself. 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`. From 9ad4c7861dd71daa2e3ad196e58a6cdc17f4cff8 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 15:11:20 +0000 Subject: [PATCH 3/3] Document only per-page hide-header-tabs frontmatter Co-Authored-By: bot_apk --- fern/products/docs/pages/navigation/frontmatter.mdx | 8 +------- .../docs/pages/navigation/site-level-settings.mdx | 4 ++-- 2 files changed, 3 insertions(+), 9 deletions(-) diff --git a/fern/products/docs/pages/navigation/frontmatter.mdx b/fern/products/docs/pages/navigation/frontmatter.mdx index 22af60d392..3a440100ee 100644 --- a/fern/products/docs/pages/navigation/frontmatter.mdx +++ b/fern/products/docs/pages/navigation/frontmatter.mdx @@ -281,14 +281,8 @@ hide-page-actions: true ## Header - - Hides the site header (logo, search, navbar links, and tabs) on this page. Useful for a custom landing page that supplies its own navigation. - - To hide the header across the site, set [`layout.disable-header`](/learn/docs/configuration/site-level-settings#layoutdisable-header) in `docs.yml`. A page cannot show a header hidden by this site-level setting. - - - Hides the tabs row on this page while keeping the header bar itself. 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`. + 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`. diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx index f0d9e9ef7c..a668ba8b14 100644 --- a/fern/products/docs/pages/navigation/site-level-settings.mdx +++ b/fern/products/docs/pages/navigation/site-level-settings.mdx @@ -614,6 +614,8 @@ layout: 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. + This setting is ignored when `disable-header` is set to true. @@ -631,8 +633,6 @@ layout: If set to true, the header won't be rendered. Instead, the logo will be rendered as part of the sidebar, and a 1px border will separate the sidebar from the content. - - Individual pages can hide the header, or only its tabs, using the [frontmatter](/learn/docs/configuration/page-level-settings#header). A page can't show a header that this setting hides.