{
  "id": 15965050,
  "title": "Duplicate titles and meta descriptions on a docs site",
  "url": "https://urgent.news/2026/10/21/duplicate-titles-and-meta-descriptions-on-a-docs-site",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-10-21T22:57:48.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/headlark/duplicate-titles-and-meta-descriptions-on-a-docs-site-ape"
  },
  "original_language": "en",
  "account": "Docs sites often duplicate pages, resulting in multiple pages with identical titles and descriptions. This causes search engine issues, as Google prefers unique descriptions for each page. When numerous pages share the same description, it becomes challenging for users to identify the most relevant page. The root cause of these duplicates varies by the documentation framework used.\n\nDocusaurus uses the first line of Markdown content as the page description if no description is specified in the front matter. It also disregards certain elements, like imports, code blocks, and headings, but not all, leading to recurring descriptions. Versioned documentation leads to duplicate pages, each carrying identical titles and descriptions. Titles are derived from the title front matter, the Markdown heading, the doc ID, and the site title. Two pages with the same title in different sections become two identical titles.\n\nStarlight utilizes the site-wide description in its config file for all pages without a defined description. Moreover, the site-wide description in the Starlight configuration is applied to every page that lacks its own description. Consequently, the greater the number of pages without front matter descriptions, the higher the likelihood of pages sharing the same site description.\n\nVitePress sets a required title for every page, with the description being optional. The site-wide description in the .vitepress/config file is applied to all pages lacking a custom description. The title for each page is either the front matter title or the text of the first h1 tag, followed by the titleTemplate suffix. The same issues as Starlight arise due to a single description for all pages and repeated headings resulting in duplicated titles.\n\nTo identify these duplicate titles and descriptions, check the HTML produced by the framework, not the source files. Use commands like grep to search for meta name=\"description\" and title within the generated HTML files. For each framework, specific commands are provided to find duplicated titles and descriptions. Once identified, modify the relevant pages by setting both the title and description in the front matter for Docusaurus, Starlight, and VitePress. Aim for unique descriptions that lead with the page's content, are approximately 70 to 155 characters long, and include distinguishing details. Implement a CI check to ensure no new duplicates are introduced during the development process.",
  "summary": "Originally published on headlark.com . Docs sites grow by copying pages. A new section starts as a copy of an old one, every product area gets an \"Overview\" and a \"Configuration\" page, and the framework fills in whatever the front matter leaves out. The result is dozens of pages that tell search engines the same thing in their <title> and <meta name=\"description\"> . Google asks for a distinct…",
  "key_points": [
    "Duplicate titles and meta descriptions cause search engine issues",
    "Docusaurus derives descriptions from first Markdown line, disregarding some elements",
    "Starlight and VitePress use site-wide description for pages without custom descriptions"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}