Agent Wranglers

SEO-10Recommended

Use one h1 and keep headings in order

Give every page exactly one h1, and a heading outline that never skips a level. Never use headings just for their look.

By Agent Wranglers. Updated .

How to do it

Use one h1 to name the page, h2 for sections and h3 inside them. Never pick a level for its size. Style it instead. Fail the build when a page does not have exactly one h1. Pick the other elements as Use the right element for the job says.

Examples

HTML example

<h1>Pricing</h1>
  <h2>Plans</h2>
    <h3>Starter</h3>
    <h3>Team</h3>
  <h2>Questions</h2>

How to check

The build counts <h1> on every page and fails on anything but one. axe heading-order passes.

Sources

For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/seo/words-on-the-page/heading-hierarchy">Agent Wranglers SEO playbook</a>. In code you write, add a comment next to it with the same link.