From 696de3d8474bc221cd3297ed9b27daf655270aeb Mon Sep 17 00:00:00 2001 From: brandonmcconnell Date: Tue, 1 Sep 2026 13:18:45 -0700 Subject: [PATCH 1/3] docs: document documentTitle frontmatter Explain how to set the browser tab title independently of the on-page heading. Co-authored-by: Cursor --- .claude/skills/mintlify/SKILL.md | 3 ++- .claude/skills/mintlify/reference/configuration.md | 3 ++- optimize/seo.mdx | 3 ++- organize/pages.mdx | 9 +++++++-- 4 files changed, 13 insertions(+), 5 deletions(-) diff --git a/.claude/skills/mintlify/SKILL.md b/.claude/skills/mintlify/SKILL.md index b78d65c10d..10b6e6aa0b 100644 --- a/.claude/skills/mintlify/SKILL.md +++ b/.claude/skills/mintlify/SKILL.md @@ -85,9 +85,10 @@ keywords: ["relevant", "search", "terms"] | Field | Type | Required | Description | |-------|------|----------|-------------| -| `title` | string | Yes | Page title in navigation and browser tabs. | +| `title` | string | Yes | Page title in navigation and as the on-page heading. | | `description` | string | No | Brief description for SEO. Displays under the title. | | `sidebarTitle` | string | No | Short title for sidebar navigation. | +| `documentTitle` | string | No | Browser tab title. Falls back to `title`. | | `icon` | string | No | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. | | `tag` | string | No | Label next to page title in sidebar (e.g., "NEW"). | | `hidden` | boolean | No | Remove from sidebar. Page still accessible by URL. | diff --git a/.claude/skills/mintlify/reference/configuration.md b/.claude/skills/mintlify/reference/configuration.md index 07969191d3..004a2b0b31 100644 --- a/.claude/skills/mintlify/reference/configuration.md +++ b/.claude/skills/mintlify/reference/configuration.md @@ -31,9 +31,10 @@ The SKILL.md file lists common frontmatter fields. Here is the complete set: | Field | Type | Required | Description | |-------|------|----------|-------------| -| `title` | string | Yes | Page title in navigation and browser tabs. | +| `title` | string | Yes | Page title in navigation and as the on-page heading. | | `description` | string | No | Brief description for SEO. Displays under the title. | | `sidebarTitle` | string | No | Short title for sidebar navigation. | +| `documentTitle` | string | No | Browser tab title. Falls back to `title`. | | `icon` | string | No | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. | | `iconType` | string | No | Font Awesome icon style: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. | | `tag` | string | No | Label next to page title in sidebar (e.g., "NEW"). | diff --git a/optimize/seo.mdx b/optimize/seo.mdx index 0c4167e92a..d674267361 100644 --- a/optimize/seo.mdx +++ b/optimize/seo.mdx @@ -28,7 +28,7 @@ Mintlify generates the following meta tags for every page. You can override thes **Page-specific metadata:** -- `title` - Page title, formatted as "Page Title - Site Name" +- `title` - Browser tab title, formatted as "Page Title - Site Name". Set `documentTitle` in frontmatter to change the page-title portion without changing the on-page heading. - `og:title` - Open Graph title, defaults to page title - `twitter:title` - Twitter title, falls back to `og:title`, then page title - `description` - Page description @@ -199,6 +199,7 @@ Page-specific meta tags include: - `title` - Page title - `description` - Page description appears below the title on the page and in some search engine results - `canonical` - Canonical URL for this page, overrides the auto-generated canonical +- `documentTitle` - Browser tab title. Site name is still appended. Does not change the on-page heading or `og:title` - `keywords` - Comma-separated keywords - `og:title` - Open Graph title for social sharing - `og:description` - Open Graph description, falls back to `description` diff --git a/organize/pages.mdx b/organize/pages.mdx index 94a09ce608..457757d1fc 100644 --- a/organize/pages.mdx +++ b/organize/pages.mdx @@ -16,13 +16,13 @@ All frontmatter fields are optional. If you omit `title`, Mintlify generates one Use frontmatter to control: - Page titles and descriptions -- Sidebar titles, icons, and tags +- Sidebar titles, browser tab titles, icons, and tags - Page layouts - SEO meta tags - Custom metadata - The title of your page that appears in navigation and browser tabs. + The title of your page. Displays as the H1 heading and is the default for navigation, browser tabs, and social sharing titles. If omitted, Mintlify generates a title from the path. The last segment of the path becomes the title, with dashes and underscores replaced by spaces and the first letter capitalized. For example, `guides/getting-started.md` becomes **Getting started**. @@ -35,6 +35,10 @@ Use frontmatter to control: A short title that displays in the sidebar navigation. + + The title used in the browser tab and HTML `` tag. If omitted, Mintlify uses `title` and appends your site name. The on-page heading is unchanged. +</ResponseField> + <ResponseField name="icon" type="string"> The icon to display. @@ -105,6 +109,7 @@ Use frontmatter to control: title: "About frontmatter" description: "Frontmatter is the metadata that controls how your page appears and behaves" sidebarTitle: "Frontmatter" +documentTitle: "About frontmatter | Metadata" icon: "book" tag: "NEW" --- From 64f0b70af4312c0b61447f7d4cd494b7aaa23291 Mon Sep 17 00:00:00 2001 From: brandonmcconnell <brandon@mintlify.com> Date: Tue, 1 Sep 2026 16:44:35 -0700 Subject: [PATCH 2/3] match sibling list punctuation and drop og:title mention Co-authored-by: Cursor <cursoragent@cursor.com> --- optimize/seo.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/optimize/seo.mdx b/optimize/seo.mdx index d674267361..731d259cde 100644 --- a/optimize/seo.mdx +++ b/optimize/seo.mdx @@ -28,7 +28,7 @@ Mintlify generates the following meta tags for every page. You can override thes **Page-specific metadata:** -- `title` - Browser tab title, formatted as "Page Title - Site Name". Set `documentTitle` in frontmatter to change the page-title portion without changing the on-page heading. +- `title` - Browser tab title, formatted as "Page Title - Site Name", set `documentTitle` in frontmatter to change the page-title portion without changing the on-page heading - `og:title` - Open Graph title, defaults to page title - `twitter:title` - Twitter title, falls back to `og:title`, then page title - `description` - Page description @@ -199,7 +199,7 @@ Page-specific meta tags include: - `title` - Page title - `description` - Page description appears below the title on the page and in some search engine results - `canonical` - Canonical URL for this page, overrides the auto-generated canonical -- `documentTitle` - Browser tab title. Site name is still appended. Does not change the on-page heading or `og:title` +- `documentTitle` - Browser tab title, site name is still appended, does not change the on-page heading - `keywords` - Comma-separated keywords - `og:title` - Open Graph title for social sharing - `og:description` - Open Graph description, falls back to `description` From 39ea0008c13406b16bff7dbe56806be7a33ff618 Mon Sep 17 00:00:00 2001 From: Brandon McConnell <brandon@dreamthinkbuild.com> Date: Tue, 1 Sep 2026 17:10:56 -0700 Subject: [PATCH 3/3] Update optimize/seo.mdx Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> --- optimize/seo.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/optimize/seo.mdx b/optimize/seo.mdx index 731d259cde..77d4455192 100644 --- a/optimize/seo.mdx +++ b/optimize/seo.mdx @@ -28,7 +28,7 @@ Mintlify generates the following meta tags for every page. You can override thes **Page-specific metadata:** -- `title` - Browser tab title, formatted as "Page Title - Site Name", set `documentTitle` in frontmatter to change the page-title portion without changing the on-page heading +- `title` - On page H1 title and browser tab title, formatted as "Page Title - Site Name". Set `documentTitle` to change the page-title portion without changing the on-page heading - `og:title` - Open Graph title, defaults to page title - `twitter:title` - Twitter title, falls back to `og:title`, then page title - `description` - Page description