How to Fix Heading Order: One H1 and No Skipped Levels
This check fails when a page has no H1, jumps heading levels (for example H2 straight to H4), or contains headings with no readable text. By the end of this guide you will have mapped your page outline, given it one descriptive H1, re-leveled skipped headings, removed or filled empty headings, and confirmed the result with an accessibility scanner.

Why it matters
Screen reader users often move through a page by heading, using the H key or a headings list, to find the section they need. A missing H1, skipped levels or empty headings make that list confusing or misleading. Search engines and AI answer engines also use headings to understand which content belongs to which topic, so a clean outline helps them extract and cite the right passage.
The ranking effect is small, but the fix usually takes minutes, often in a single shared template.
What you need
Step-by-step fix
Map the current heading outline
Open the page, press F12, go to the Console tab and paste the snippet below. It prints every heading in document order, indented by level, and labels empty ones. Look for three things:
- No level 1 heading
- A level that jumps by more than one from the previous heading (for example 2 to 4)
- Headings marked EMPTY
document.querySelectorAll('h1,h2,h3,h4,h5,h6,[role="heading"]').forEach(h => {
const lvl = h.getAttribute('aria-level') || h.tagName.replace('H','');
const txt = (h.innerText || '').trim() || h.querySelector('img[alt]')?.alt || '';
console.log(' '.repeat(lvl - 1) + 'H' + lvl + ': ' + (txt || '⚠ EMPTY'));
});Give the page exactly one descriptive H1
The H1 should state what this specific page is about, usually the page title or product name. If your logo or site name is wrapped in an H1 or H2 on every page, change it to a plain link or <p>. If a theme hides the visible title, keep a real H1 in the content rather than relying on a hidden one.
<!-- Before --> <h1 class="logo"><a href="/">Example Co</a></h1> <h2 class="page-title">Trail Running Shoes</h2> <!-- After --> <a class="logo" href="/">Example Co</a> <h1 class="page-title">Trail Running Shoes</h1>
Re-level skipped headings
Work down the outline. Each heading may go down only one level at a time (H2 then H3), and it can jump back up to any higher level. If someone picked H4 because it "looked right", change it to the correct level and keep the appearance with a CSS class.
**
<!-- Before: H2 jumps to H4 -->
<h2>Features</h2>
<h4>Waterproof upper</h4>
<!-- After -->
<h2>Features</h2>
<h3 class="text-small-heading">Waterproof upper</h3>
<style>
.text-small-heading { font-size: 1rem; font-weight: 600; }
</style>Turn decorative "headings" into normal text
Labels such as "Free shipping", "Follow us", newsletter prompts, testimonial names and card prices are often marked up as H4–H6 only to make them bold. If the text does not introduce a section of content, change it to <p> or <span> with a class. This removes many skipped-level errors in sidebars and footers.
<!-- Before --> <h5 class="widget-title">Follow us</h5> <!-- After --> <p class="widget-title">Follow us</p>
Fix or remove empty headings
An empty heading has no text that assistive technology can read. Common causes are:
- Spacer headings left behind by a page builder
- Icon-only headings
- Images with an empty
alt - Text inside
aria-hidden="true"
Delete headings that only exist for spacing, and use CSS margin instead. For headings that contain only an image or icon, add real text or meaningful alt text.
<!-- Before --> <h2></h2> <h2><img src="/badge.svg" alt=""></h2> <h3><i class="icon-star" aria-hidden="true"></i></h3> <!-- After --> <h2><img src="/badge.svg" alt="Award-winning support"></h2> <h3><i class="icon-star" aria-hidden="true"></i> Customer favourites</h3>
Update shared templates and components
Apply the same fixes at the source so they do not come back. Check the following:
- Header and logo partials
- Sidebar and widget title settings
- Product card and blog card components
- Footer columns
- Reusable blocks
If a component is used at different depths on different pages, let editors or the parent pass in the heading level instead of hard-coding it.
// React/Next.js: let the parent choose the level
export function Card({ title, level = 3, children }) {
const Heading = `h${level}`;
return (
<div className="card">
<Heading className="card-title">{title}</Heading>
{children}
</div>
);
}Re-test the page
Clear any page or CDN cache, reload the page and run the console snippet again. Then run axe DevTools (DevTools > axe DevTools > Scan all of my page) or Lighthouse (DevTools > Lighthouse > Accessibility > Analyze page load). Confirm there are no results for Heading levels should only increase by one, Page should contain a level-one heading or Headings should not be empty.
Platform-specific notes
WordPress
In the block editor, open **Document Overview** (the list icon in the top toolbar) and choose the **Outline** tab. It shows every heading and flags skipped levels. Change a level with the H dropdown in the Heading block toolbar. Sidebar and footer widget titles often come from the theme. In block themes, edit them under **Appearance > Editor > Patterns/Template Parts**. In classic themes, check the `before_title` argument of `register_sidebar` in functions.php or the theme's options. Page builders such as Elementor set the tag under **Heading widget > Content > HTML Tag**.
Shopify
Section headings are set in theme code. Go to **Online Store > Themes > ... > Edit code**, open the files in `sections/`, and look for tags like `<h2 class="{{ section.settings.heading_size }}">`. The heading size setting usually changes only the CSS class, not the tag. Product pages use an H1 in `main-product.liquid` or a product block snippet. Check that the logo in `header.liquid` is an H1 only on the homepage, or not at all.
Wix
Choosing a text theme such as "Heading 3" sets both the style and the tag. To change only the tag, select the text and open **Settings (gear) > Advanced SEO > Semantic HTML tag** in Wix Studio, or use the SEO/accessibility tag option in the Wix Editor text panel. Use **Settings > Accessibility Wizard** to list heading issues across a page.
Webflow
Select a Heading element and change **H1–H6** under **Element Settings (D) > Tag**. Keep the visual size in a class, such as `.heading-small`, so changing the tag does not change the design. Check Symbols and CMS Collection templates, because one wrong tag there repeats on every item.
Next.js / React
Hard-coded `<h3>` tags inside reusable components are the most common cause of skipped levels. Pass a `level` or `as` prop from the parent. If you use MDX, a markdown `####` under a `##` produces a skipped level, so fix it in the content files.
Check that it worked
✅ How to verify
- Run the DevTools console snippet again and confirm there is one H1, no level jumps greater than one, and no ⚠ EMPTY lines.
- Scan with axe DevTools and confirm the heading-order, page-has-heading-one and empty-heading rules no longer appear.
- Run a Lighthouse Accessibility audit and confirm "Heading elements are not in a sequentially-descending order" no longer appears under failed audits.
- Open the headings list in a screen reader (NVDA: Insert+F7; VoiceOver: VO+U, then Headings) and check that the list reads like a sensible table of contents.
⚠️ Common mistakes
- Choosing heading tags for their font size instead of their place in the outline, and then skipping levels to get a smaller look.
- Fixing the content but leaving the logo, sidebar widgets or footer columns as H2–H6 in the theme template, so the error returns on every page.
- Hiding an empty or decorative heading with display:none or aria-hidden instead of deleting it or turning it into normal text.
- Making every section an H1, or leaving the page with no H1 because the theme renders the title as a styled div.
Is this still an issue on your site? Run a free audit — ZORO checks this and 294 other SEO, AI-visibility, accessibility and security signals, with fixes for your platform.
Check my site freeFAQ
Is it bad for SEO to skip heading levels?
Google has said heading order is not a direct ranking factor. However, a clear outline helps search engines and AI tools work out what each section covers, and it matters a lot for screen reader users. Treat it as low-effort accessibility and clarity work, not a ranking lever.
Can a page have more than one H1?
HTML allows it, and Google handles it. This check only requires at least one level-one heading. Using exactly one H1 for the main topic still gives the clearest structure and is what most accessibility guidance recommends.
Can I go from H3 back to H2?
Yes. Moving back up to any higher level is fine, because it starts a new section. Only moving down by more than one level, such as H2 to H4, is flagged.
Does the first heading on the page have to be the H1?
No, it is not strictly required. A heading in the site header can come before the H1. It is still best to keep pre-content headings to a minimum and make the H1 the first heading inside the main content area.
How to Fix a Missing Main Landmark and Unwrapped Content
How to Fix a Missing or Empty Page Title Element
How to Add a Skip to Content Link for Keyboard Users
How to Fix a Missing or Invalid Page Language (html lang)
How to Fix Invalid ARIA Attributes and Roles on Your Site
How to Fix Links Without Discernible Text on Your Site