Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Blogging & content · Guide

How to Add an H1 Tag in WordPress (and Fix Missing or Duplicate H1s)

How to Add an H1 Tag in WordPress (and Fix Missing or Duplicate H1s)

Short answer

In most WordPress themes, the post or page title you type at the top of the editor becomes the H1 tag automatically, so you do not need to add one yourself. If your theme hides the title or a page builder replaces it, add a Heading block or widget and set its level to H1. Use one clear H1 per page and H2 to H6 for subheadings.

Key takeaways

  • WordPress themes normally output the page or post title as the H1.
  • Headings inside your content should usually start at H2.
  • If the title is hidden, add a Heading block or widget set to H1.
  • One clear, descriptive H1 per page helps readers and search engines.
  • Check the real HTML with your browser's developer tools, not just how text looks.

What is an H1 tag?

An H1 tag is the main heading of a web page in HTML, describing what the page is about, while H2 to H6 tags form the subheadings beneath it in a clear outline.

MDN's reference for the heading elements explains how the six heading levels create a document structure that browsers, screen readers and search engines use.

Think of the H1 as the title of a book chapter and the H2s as its sections. Our explainer on what H3 is in WordPress covers how lower levels fit in.

Where does WordPress put the H1?

Most themes turn the title you enter at the top of the editor into the page's H1, on posts, pages and products, so a normal post already has an H1 without extra work.

This is why the block editor's heading tools start at H2 by default. Adding another H1 inside the content would create a second main heading.

On the homepage and archive pages, themes behave differently. Some use the site name as the H1 on the homepage, while others use the page title or a category name.

What H1 should the homepage have?

Give the homepage one H1 that says what your site or business does, such as your main service and location, rather than a vague welcome message or just the logo.

Many themes wrap the site title or logo in an H1 only on the homepage. That works if the site title describes the business, but a line like Welcome adds nothing for readers or search engines.

If your homepage uses a static page, its title or a Heading block can serve as the H1. Hide the visual page title only if another heading on the page is set to H1.

How do you check which H1 a page has?

Open the page, right-click the main title and choose Inspect, then look at the highlighted HTML tag, or view the page source and search for h1.

What matters is the HTML tag, not the text size. A big bold line might be a paragraph styled to look large, and a small line could still be an H1.

Browser extensions and SEO tools can list every heading on a page in order. That makes it easy to spot a missing H1, two H1s or skipped levels.

How do you add an H1 in the block editor?

If your theme shows the title, you already have an H1. If the title is hidden, add a Heading block at the top of the content and choose H1 from the heading level menu in the toolbar.

  1. Open the page in the block editor
  2. Click the plus button and add a Heading block
  3. Type your main heading
  4. Click the heading level button in the block toolbar
  5. Choose H1
  6. Update the page and check the HTML

The WordPress documentation for the Heading block shows where the level options sit.

Only do this when the theme's title is hidden, otherwise the page ends up with two H1 tags.

How do you set the H1 in block themes?

In block themes, open Appearance > Editor, edit the template for posts or pages, select the Title block and check its heading level in the block toolbar; it is usually set to H1.

The Title block displays the post or page title inside templates. Changing its level in the template changes it for every page that uses that template.

The homepage template may use a different heading for the site title. Check each important template once, rather than assuming they all match.

What about category and archive pages?

Archive pages, such as categories, tags and author pages, usually get an H1 from the archive title, so name categories clearly and add a short description where your theme displays it.

A category called Misc or Uncategorised makes a poor H1. Rename it to something meaningful under Posts > Categories, and the heading updates automatically.

In block themes, archive templates use the Query Title block for this heading. Check its level in the template the same way you check the Title block.

How do you add an H1 with Elementor or other page builders?

Add a Heading widget, type your title and set its HTML tag to H1 in the widget settings, especially on canvas or full-width layouts that hide the theme's title.

Page builders often let you hide the page title in the page settings. If you do, make sure one heading on the page is set to H1.

Keep the other headings as H2 or lower, even if you style them large. Our guide on how to use Elementor in WordPress covers widget settings in more detail.

How do you fix two H1 tags on a page?

Find where each H1 comes from, then change the extra one to H2 or remove it, usually a Heading block or widget set to H1 while the theme also prints the title.

Common sources of duplicate H1s are a logo wrapped in an H1 in the header, a Heading block at the top of content, and page builder templates that add their own title.

If the extra H1 comes from the theme header, check the theme's settings first. Some themes let you choose the logo's tag, and changing theme files should be a last resort, done only in a child theme.

HTML technically allows several H1 tags, but one clear main heading is simpler for readers and assistive technology. It also makes the page topic obvious.

How do you fix a missing H1?

If a page has no H1, the theme or builder is hiding the title; show the title again in the page settings, or add a Heading block or widget set to H1 at the top.

Missing H1s often happen on landing pages, homepages and pages built with full-width templates. They are easy to miss because the design still looks complete, and visitors rarely notice anything wrong until a tool or audit points it out.

After fixing, run the page through your browser's inspector again. Many SEO plugins also flag missing H1 headings in their analysis.

What makes a good H1?

A good H1 says clearly what the page is about, includes the main topic naturally, matches what the visitor expected when they clicked, and stays reasonably short.

Write for people first. Google's SEO Starter Guide recommends clear, descriptive headings that help readers understand the page.

The H1 and the SEO title do not have to be identical. The H1 is what visitors see on the page, while the SEO title appears in search results and browser tabs.

How should headings below the H1 be structured?

Use H2 for main sections, H3 for subsections inside an H2, and so on, without skipping levels just to get a certain text size, since styling should come from CSS or block settings.

A logical outline helps people who use screen readers jump between sections. The W3C's headings tutorial explains why heading order matters for accessibility.

If a heading looks too big or too small, change its font size in the block settings rather than switching to a different heading level. Block themes also let you set default heading sizes once in the Styles panel of the Site Editor.

Does the H1 matter for SEO?

The H1 is one of many signals that help search engines understand a page, so a clear H1 helps, but it is not a magic ranking factor on its own.

Good content, helpful answers and a sensible structure matter much more than the exact wording of one tag. Our explainer on WordPress SEO covers the bigger picture.

Focus on making the H1 accurate, specific and genuinely useful to the people reading the page. If it truly describes the page, it does its job for both visitors and search engines.

Frequently asked questions

Does WordPress add an H1 tag automatically?

In most themes, yes. The title you enter at the top of the post or page editor becomes the H1. Some themes and page builder layouts hide it, in which case you need to add one yourself.

Should I use H1 inside my post content?

Usually not. Because the title is already the H1, start headings in your content at H2. Only add an H1 in content if the theme hides the page title.

Is it bad to have two H1 tags?

It is not an error in HTML, but one clear H1 is better for readers, accessibility tools and search engines. Change extra H1 headings to H2 or remove them.

How do I see which heading tags a page uses?

Right-click a heading and choose Inspect in your browser to see its HTML tag, or view the page source and search for h1. SEO browser extensions can list every heading in order.

Should the H1 match the SEO title?

Not necessarily. They should describe the same topic, but the SEO title can be tuned for search results while the H1 is written for visitors already on the page.

Sources

  1. The HTML Section Heading elements MDN Web Docs
  2. Heading block WordPress.org Documentation
  3. SEO Starter Guide Google Search Central
  4. Headings W3C Web Accessibility Initiative

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.