Use exactly one H1 per page

Each page needs one H1 that names its topic. Multiple H1s usually come from logos or reused components that each include a heading. Audit rendered HTML, keep the H1 visible and near the main content, and let H2 and H3 carry the subsections. One H1 is a structure fix, not a ranking trick.

mediumIn codeimpact effort

Why this matters

A duplicate H1 usually means a template bug, not extra relevance.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

  • A crawl of rendered HTML

How to apply it

  1. Count H1s in rendered HTML General best practice

    Crawl the site and count h1 elements per URL. Flag pages with zero or more than one, and identify the component that emits the extra heading.

    Check: The crawl report lists H1 count per URL and the offending template for each anomaly.

  2. Make the page title the only H1 General best practice

    Change reused components to accept a heading level, and change logo wrappers to a div. Keep the H1 visible and place it before the main content sections.

    Check: The rendered HTML contains exactly one h1 element containing the page topic.

  3. Check the outline General best practice

    Review the heading outline with an accessibility tool. Sections should start at H2, with H3 only inside an H2 section.

    Check: The outline has one H1 and no skipped levels.

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

nextjs-app

Keep the `<h1>` in each `page.tsx` and keep the logo in `layout.tsx` as a div or span; a layout-level H1 duplicates on every route.

sveltekit

Move the page title into `+page.svelte` and keep `+layout.svelte` free of headings so shared chrome does not add an H1.

Official references

Let your agent apply this + 161 more tips.

Pre-order — $19