Headings have non-empty text

heading_not_empty

Checks that heading tags (H2-H6) have non-empty text.

What does this rule check?

All heading elements should contain meaningful text that describes the section below them. Empty headings waste structural signals and create confusing navigation for assistive technologies.

Why is this important?

Empty headings provide no value for SEO or accessibility. They confuse the document outline and screen reader navigation.

How to fix

Add descriptive text to empty heading tags or remove them if they serve no structural purpose.

Examples

<h2></h2>
<p>Some content without a heading...</p>

<h2>Product Features</h2>
<p>Our product includes the following features...</p>

Agent fix snippet

Copy this snippet and paste it into your AI coding agent to fix this issue automatically.

Find all empty heading tags (h2-h6) and add descriptive text or remove them.