Rules / heading rules

heading.exists

Default

error

Plugin

heading

A page has an <h1>.

Why: The <h1> names the main topic of the page. Search engines and screen readers rely on it.

When off: pages without an <h1> pass.

<!-- ✗ Fails -->
<body>
  <h2>Our bread</h2>
</body>

<!-- ✓ Passes -->
<body>
  <h1>Our bread</h1>
</body>

References

• axe: page-has-heading-one: The same check in axe-core.
• W3C WAI: Headings: The main heading of a page is the <h1>.