Skipped heading levels: fixing a page with H3s but no H2

What it looks like in the HTML

Before

<h1>Cold Brew at Home</h1>
<h3>What you need</h3>
<h3>Step-by-step method</h3>
<h4>Steeping time</h4>

After

<h1>Cold Brew at Home</h1>
<h2>What you need</h2>
<h2>Step-by-step method</h2>
<h3>Steeping time</h3>

Why it matters

Headings form a tree. The H1 is the page, H2s are its main sections, H3s are subsections of an H2, and so on. Assistive technology exposes that tree: screen reader users can list all headings or jump between headings of one level. When the H2 level is missing, "jump to next H2" finds nothing, and the list of headings reads like fragments.

The same tree helps anyone skimming, and it helps machines summarize the page. A clean outline costs nothing to keep once the pattern is right.

What causes it on WordPress sites

The flag often comes from headings you did not write:

• The comment form. WordPress's default comment form prints "Leave a Reply" as an H3. A short post with no H2s in its content, and comments open, has an H3 and no H2.
• Widgets and footers. Many themes print sidebar and footer widget titles as H3 or H4. On a page whose content has no H2s, these become the only subheadings.
• Related posts and author boxes. Plugins often use H3 or H4 for "Related posts" or an author name.
• Headings chosen for size. Authors pick H3 because H2 looks too big in their theme, or a page builder heading is set to H4 for styling.

How to fix it in WordPress

1. Look at the whole outline. In the browser console, run [...document.querySelectorAll('h1,h2,h3,h4,h5,h6')].map(h => h.tagName + ' ' + h.textContent.trim()) to list every heading in order, including ones from the theme and plugins.
2. Fix content headings first. In the block editor, open the Document Overview in the list view to see your headings. Change the top-level section headings to H2 and nest the rest below them. If H2 looks too large, change its size in the block's typography settings or your theme styles, not by picking a lower level.
3. In page builders, select each heading and set its HTML tag to match its place in the structure. Keep the visual size separate.
4. For theme and plugin headings, check their settings first; some let you choose the tag for widget titles or related posts. Otherwise, a child theme or a filter can change them. The comment form's title markup can be changed through the comment_form_defaults filter.
5. Consider whether short posts need an H2. A post long enough to have sections should have H2 section headings. That alone usually clears the flag.

Hydrogen SEO does not rewrite headings. Heading structure is part of the Content structure area in its site health score.

When you can ignore this warning

If the only H3 on the page is a theme or plugin element, such as the comment form title on a short announcement, and the content itself has no sections, the practical impact is small. You can leave it, or change the component's heading level once and fix every page that uses it. Do not add a meaningless H2 just to satisfy the check.

How to check the fix

Run the console snippet above again and read the list top to bottom: it should go H1, then H2s, with H3s only under an H2. Clear your page cache first. The free SEO audit shows the H1, H2 and H3 counts for any URL.