Multiple H1 tags: when it matters and how to fix it

Google has said its systems handle a page with several H1s, so this is not a penalty. It is still flagged because more than one H1 is usually an accident: a logo, a sidebar widget or a repeated component marked up as the main heading. Keep one H1 for the page topic and demote the rest.

Updated 28 September 2026

Severity
Warning
Issue type
multiple-h1
How the audit flags it
An HTML page returning 2xx is flagged when it has two or more <h1> elements with text in them. Empty H1s are not counted. The issue records how many H1s the page has.
How to check
One URL at a time in the free SEO checker, or every page in a site audit.

Does it matter?

Less than many audit tools imply. HTML allows several H1s, and Google has said more than once that its systems understand pages that use them. There is no ranking penalty to remove.

The case for fixing it is clarity. One H1 is the most direct way to say what a page is about, to readers, to screen readers that list headings, and to any crawler or AI system that summarises the page. When the H1s are the site name, a newsletter box and the article title, the one that matters is diluted by two that do not.

So treat it as a warning about the template, not about the page. If the extra H1s are deliberate, for example a long single-page document with several equal parts, leaving them is a reasonable choice.

The usual causes

  • The logo or site name is an H1 in the header, and the page title is an H1 too.
  • A reusable component (a card, a callout, a modal, a newsletter signup) renders its own heading as an H1 wherever it is placed.
  • A page builder or CMS block defaults to H1 for every "large heading".
  • The mobile and desktop layouts each render the headline, one hidden with CSS, so the HTML has two.

How to fix it

View the page source and list every <h1>. Decide which one states the page's topic; that one stays. The others become h2 or h3 if they introduce a section, or a plain element if they are not headings at all, such as a logo.

Fix it where it comes from. A component that hard-codes an H1 should accept the heading level as a prop, so the page decides. A duplicated mobile headline should be one element that the layout rearranges, not two copies.

Keep the visual design. Heading level is semantics, and the styling can stay exactly as it is.

The free SEO checker reports the H1 count for one URL, so you can confirm the fix on a sample page before re-running the full audit.

Fix it with a coding agent

Connect Claude Code, Cursor or Codex to IndexZero's MCP server, open your site's repo, and paste:

Run a site audit of example.com and wait until it completes. Read the multiple-h1 issues and, for a few affected URLs, fetch the HTML and list every h1 with its text. Work out which component or layout adds the extra ones, find it in this repo, and change it so each page keeps one h1 for its main topic and the others become h2 or a non-heading element. Keep the styling unchanged. Show me the diff before committing.

Behind that prompt the agent calls run_site_audit, polls get_audit_status until the crawl completes, and reads get_audit_issues with issueType: "multiple-h1". Your repo is where the fix happens: IndexZero reads your site and never changes it.

Frequently asked questions

Is having two H1 tags bad for SEO?
Not in the sense of a penalty. Google handles it. It is worth fixing when the extra H1 is an accident, because one clear main heading is easier for readers, screen readers and crawlers to interpret.
Does HTML5 allow multiple H1s?
Yes. The old HTML5 outline algorithm that gave each section its own H1 was never implemented by browsers or screen readers, though, so a flat hierarchy with one H1 is the safer choice.

Audit the whole site

Find every page with this issue

An agent connected to IndexZero's MCP server can crawl the whole site, read the issues of one type, find the templates in your repo and fix them, then re-crawl to confirm. The crawl itself spends no credits; only the optional Lighthouse sample does. The free plan includes the MCP server, audits of up to 50 pages, and 2,000 credits a month.

Start freeHow to connect an agent

Related issues