Skip to content

Rule · Lint

More than one <h1> in a route's page + layouts

lint/multiple-h1warnvoid lintupdated

Why it matters

Multiple h1 elements blur the page topic for search engines and make heading navigation confusing for screen-reader users.

How to fix it

Keep exactly one

per route (usually in the page) and use

+ for sections; logos in layouts shouldn't be h1.

Example

tsx
<h1>Pricing</h1>
<section><h2>Enterprise</h2></section>

void lint reports 67 rules in this category. Static source checks with no browser: Tailwind v4 silent failures, Next.js 16 API traps, React render-body bugs, accessibility markup, SEO files and motion hygiene.