Skip to content

Rule · Accessibility

Heading levels skip

a11y/heading-orderwarnvoid a11yupdated

Why it matters

Skipping from h2 to h4 breaks the document outline that assistive technology exposes.

How to fix it

Use heading levels in order; style with CSS rather than picking levels by size.

References

void a11y reports 48 rules in this category. WCAG 2.2 AA through axe-core, plus checks axe can't do alone: visible keyboard focus, 24/44px target size on mobile, 320px reflow and disabled zoom.