Skip to content
DeployAI
WarningCode a11y_heading_order

Headings skip a level or the page has no main heading

What it means

The headings on a page skip a level, for example from a subheading straight to a fourth level heading, or the page has no main heading.

Why it is only a warning

This is only a warning. Screen reader users jump between headings to understand the page, and a skipped level looks like a missing part.

How to fix it

  1. Give every page one main heading.
  2. Use heading levels in order, and keep the look the same.
  3. Run the check again.

Prompt for your agent

Copy it and paste it into your agent. It fixes the project, explains each step, and runs the check again.

The DeployAI accessibility check found this on the site: Headings skip a level or the page has no main heading.
Give every page one <h1>, then use headings in order without skipping a level (h2 under h1, h3 under h2). Pick the heading level by structure, and keep the look the same with CSS.
Explain your plan and wait for my approval before architectural changes. Do not remove features without asking.
Explain every step to me in simple words.
When done and the updated site is live, tell me to run the accessibility check again at https://deployai.co.il/en/tools/accessibility