Skip to main content

WordPress fix guide

Fix Heading structure problems on WordPress

Headings create an outline; random levels harm navigation.

Check your live page

Canonical issue page: Heading structure problems

What this issue means

Why structure matters

Screen reader users jump by headings. Skipping from h1 to h3 breaks expectations; multiple h1s can be acceptable if scoped correctly.

How to fix on WordPress

Page builders make it easy to pick heading blocks for visual hierarchy—audit outline view.

How to fix

Use levels in order for the outline; style via CSS instead of picking headings for size.

Wrap repeated sections in landmarks (header, nav, main, footer) to aid navigation.

Code example

<!-- One H1 per page in the theme; avoid skipping levels (H2 to H4) in block patterns. -->

Related: 1.3.1 Info and Relationships.

Other platforms

TestAccessibility · Programmatic fix page · localhost:3001