Safeguard
Developer Tools•

Page titles and meta descriptions for technical pages

How Google builds title links and snippets, and how to write titles and meta descriptions for docs and blog pages that are accurate, distinct and useful.

Safeguard Security Team
3 min read

Write a distinct, descriptive title for every page that names the task or topic, and a meta description that summarizes the whole page in plain words. Google may rewrite both, so accuracy and consistency with the visible page matter more than clever phrasing.

How title links are chosen

Google builds title links automatically from the page and from references to it around the web. Its sources include the title element, the main visible title, headings, og:title, other prominent text, anchor text and WebSite structured data. Changes show up only after a recrawl, which can take days to weeks, and Google says it does not manually edit titles for individual sites.

Title best practices

From Google's guidance:

  • Give every page a title element.
  • Keep it descriptive and concise. Avoid vague labels such as "Home".
  • Do not stuff keywords.
  • Make each title distinct. Boilerplate shared across many pages makes results hard to tell apart.
  • Brand briefly, with the site name after a delimiter.
  • Make the main title the most prominent text on the page, such as the first visible h1.
  • Write it in the same language as the page.

For docs, a good pattern is the task, then the product area, then the brand: "Rotate an API key | CLI docs | Example". Avoid putting a version or year in the title unless it is truly part of the topic, because Google lists obsolete titles with outdated dates as a reason it adjusts title links.

Common reasons Google rewrites a title

Half empty titles, obsolete dates, inaccurate titles, near identical titles across a set, no clear main title, and a language mismatch. Fix the cause and the original often returns.

Meta descriptions

Google may use the meta description as the snippet when it describes the page better than page text. Otherwise it builds a snippet from the content, tailored to the query.

Good practice from the snippet guidance:

  • Make them unique per page.
  • Summarize the whole page, to inform and persuade. Skip keyword lists.
  • Include useful facts such as author or date where relevant.
  • Programmatic generation is fine on large sites if the result is readable and varied.
  • There is no length limit, but results are truncated to fit device width.

A practical target for this site is about 140 to 155 characters, a habit rather than a rule.

A before and after

Before: "Docs | Example". After: "Run a dependency scan in CI: exit codes and thresholds | Example". The second tells a searcher what they will get.

Controls

nosnippet stops a snippet. max-snippet caps its length. data-nosnippet excludes specific page parts. Use them deliberately, since they also reduce what searchers see.

Quick check

Should every page have a different title?

Yes. Google says to make titles distinct, and notes near identical titles make results hard to tell apart.

Is there a character limit for meta descriptions?

Google says there is no length limit, only truncation to device width.

Sources

Last reviewed: 19 October 2026.

Never miss an update

Weekly insights on software supply chain security, delivered to your inbox.

Self-healing security runs on Safeguard.

Your first fix PR is minutes away.

No sales call required, even your agent can complete the purchase over MCP.