From b63279996c309e4a7b8adacaae249d42881706ea Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Fri, 6 Feb 2026 19:19:47 +0000 Subject: [PATCH 1/2] --message --- .../products/docs/pages/changelog/2026-02-06.mdx | 16 ++++++++++++++++ .../pages/customization/site-level-settings.mdx | 5 +++++ fern/products/docs/pages/navigation/overview.mdx | 2 +- 3 files changed, 22 insertions(+), 1 deletion(-) diff --git a/fern/products/docs/pages/changelog/2026-02-06.mdx b/fern/products/docs/pages/changelog/2026-02-06.mdx index 2b702f092..501fe2d38 100644 --- a/fern/products/docs/pages/changelog/2026-02-06.mdx +++ b/fern/products/docs/pages/changelog/2026-02-06.mdx @@ -3,3 +3,19 @@ Open Ask Fern or the search dialog directly from a URL using query parameters. Append `?searchType=ai&query={prompt}` to open Ask AI with a prompt, or `?query={search}` for regular search. Parameters are removed from the URL after the search opens. Learn more about [deep linking](/learn/docs/ai-features/ask-fern/features#deep-linking). + +## Global folder title source setting + +Set a default `title-source` for all folder navigations using the new `folder-title-source` option in `settings`. Individual folders can still override this value with their own `title-source`. + +```yaml docs.yml +settings: + folder-title-source: frontmatter + +navigation: + - folder: ./pages/guides # uses frontmatter (from global setting) + - folder: ./pages/reference + title-source: filename # overrides global setting +``` + +Learn more about [folder title source](/learn/docs/configuration/site-level-settings#settingsfolder-title-source). diff --git a/fern/products/docs/pages/customization/site-level-settings.mdx b/fern/products/docs/pages/customization/site-level-settings.mdx index fae3d513a..ebcd5df8b 100644 --- a/fern/products/docs/pages/customization/site-level-settings.mdx +++ b/fern/products/docs/pages/customization/site-level-settings.mdx @@ -654,6 +654,7 @@ settings: http-snippets: false hide-404-page: true use-javascript-as-typescript: false + folder-title-source: frontmatter substitute-env-vars: true ``` @@ -712,6 +713,10 @@ settings: If set to true, all analytics integrations configured in the [`analytics` configuration](#analytics-configuration) will be disabled. This includes Google Analytics 4, Google Tag Manager, PostHog, and any other analytics providers you have configured. + + Sets the default title source for all [folder navigations](/learn/docs/configuration/navigation#add-a-folder). When set, this value applies to any folder that doesn't specify its own `title-source`. Set to `frontmatter` to derive titles from the `title` field in each file's frontmatter, or `filename` to derive titles from file names. + + If set to true, replaces `${ENV_VAR}` expressions with environment variable values at build time. Useful for injecting API keys, base URLs, or version numbers into your docs. diff --git a/fern/products/docs/pages/navigation/overview.mdx b/fern/products/docs/pages/navigation/overview.mdx index f5703255f..7fd6ab305 100644 --- a/fern/products/docs/pages/navigation/overview.mdx +++ b/fern/products/docs/pages/navigation/overview.mdx @@ -162,7 +162,7 @@ navigation: - Determines how page and section titles with the folder are derived. By default (`filename`), titles are derived from file names. Set to `frontmatter` to use the `title` field from each file's frontmatter instead (falls back to filename if not set). + Determines how page and section titles within the folder are derived. By default (`filename`), titles are derived from file names. Set to `frontmatter` to use the `title` field from each file's frontmatter instead (falls back to filename if not set). This per-folder setting overrides the global [`settings.folder-title-source`](/learn/docs/configuration/site-level-settings#settingsfolder-title-source) value. From 60fc4120b8f2acdf70738f9b7102487af84458e8 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Fri, 6 Feb 2026 14:31:30 -0500 Subject: [PATCH 2/2] clarify description and add cross ref --- fern/products/docs/pages/changelog/2026-02-06.mdx | 4 ++++ .../products/docs/pages/customization/site-level-settings.mdx | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/fern/products/docs/pages/changelog/2026-02-06.mdx b/fern/products/docs/pages/changelog/2026-02-06.mdx index 501fe2d38..063749eb5 100644 --- a/fern/products/docs/pages/changelog/2026-02-06.mdx +++ b/fern/products/docs/pages/changelog/2026-02-06.mdx @@ -1,3 +1,7 @@ +--- +tags: ["ai", "search", "navigation", "configuration", "docs.yml"] +--- + ## Deep linking for Ask Fern Open Ask Fern or the search dialog directly from a URL using query parameters. Append `?searchType=ai&query={prompt}` to open Ask AI with a prompt, or `?query={search}` for regular search. Parameters are removed from the URL after the search opens. diff --git a/fern/products/docs/pages/customization/site-level-settings.mdx b/fern/products/docs/pages/customization/site-level-settings.mdx index ebcd5df8b..ce74324a9 100644 --- a/fern/products/docs/pages/customization/site-level-settings.mdx +++ b/fern/products/docs/pages/customization/site-level-settings.mdx @@ -714,7 +714,7 @@ settings: - Sets the default title source for all [folder navigations](/learn/docs/configuration/navigation#add-a-folder). When set, this value applies to any folder that doesn't specify its own `title-source`. Set to `frontmatter` to derive titles from the `title` field in each file's frontmatter, or `filename` to derive titles from file names. + Sets the default method for deriving page and section titles across all [folder navigations](/learn/docs/configuration/navigation#add-a-folder). By default (`filename`), titles are derived from file names. Set to `frontmatter` to use the `title` field from each file's frontmatter instead (falls back to filename if not set). Individual folders can override this global default using the per-folder [`title-source`](/learn/docs/configuration/navigation#title-source) setting.