---
name: title-tags
description: Write or fix HTML title tags so each page has a unique, accurate title that search engines and AI tools can show. Use when a user asks to improve titles, when titles repeat across pages, or when Google rewrites titles.
---

# Title tags

## Facts to use
- Google uses the `<title>` element as the main source for the title link, but it can use other text from the page.
- Google gives no fixed character limit. Long titles are cut to fit the device width. Put the important words first.
- Google's guidance: one descriptive title per page, unique across the site, concise, no keyword stuffing, no repeated boilerplate.

## Workflow
1. Crawl the site and export URL, current title, H1 and the main topic of the page.
2. Flag: missing titles, duplicates, titles that do not match the H1 topic, titles that are only the brand, and very long titles.
3. Write a new title per page:
   - Start with the thing the page is about, in the words people search for.
   - Add one detail that sets it apart (who it is for, a number from the page, the year for time-bound content).
   - End with the brand after a separator, if space allows. The home page can lead with the brand.
4. Keep the title and the H1 about the same topic. They do not need to be identical.
5. For single-page apps, make sure the title is in the raw HTML (see client-side-rendering-fix).

## Checks
- [ ] Every indexable page has exactly one title.
- [ ] No two indexable pages share a title.
- [ ] Each title states facts that the page supports.

## Output
A table: URL, old title, new title, reason. Keep each new title as short as the meaning allows.

## Sources
- Google: Influencing your title links in search results. https://developers.google.com/search/docs/appearance/title-link
