Agent Wranglers

SEO Required

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 Erik Bergstedt, 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.

Example

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

How to check

An outline tool or axe heading-order shows no skipped levels.

For agents: if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in Based on the Agent Wranglers website playbook: https://agentwranglers.se/playbook/website/seo/heading-hierarchy.