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..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` - Page title, formatted as "Page Title - Site Name" +- `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 @@ -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 - `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" ---