How to fix missing h1 on WordPress.org

Add a single, descriptive H1 tag to every page that currently lacks one, clearly stating the page's main topic.

Steps for WordPress.org

  1. For pages and posts: the page/post Title field in the Block Editor (Gutenberg) or Classic Editor automatically renders as the H1 via your theme's single.php or page.php template. Ensure the title is filled in.
  2. If your theme does not output the title as an H1, install a child theme and edit the relevant template file to wrap the_title() in <h1> tags.
  3. For pages where the title is intentionally hidden but you still need an H1, add a Heading block (set to H1) at the top of the editor content area.
  4. Plugins like Rank Math SEO or Yoast SEO will flag pages with missing H1s under their on-page analysis — use these to audit all pages at once.
Official WordPress.org documentation ↗

What is missing h1?

An H1 is the main heading on a webpage — think of it as the title printed at the top of a magazine article. It tells both visitors and search engines what the page is about in one clear phrase. Every page should have exactly one H1 tag (not zero, not three), and it should describe the page's primary topic using words your customers actually search for. On a product page that might be the product name; on a category page it might be the category name; on your homepage it might be your brand's core value proposition.

Search engines use the H1 as one of the strongest on-page signals to understand what a page covers and how it should rank. A missing H1 means Google has to guess the page topic from other less-reliable signals, which can lower your rankings for the exact keywords you care most about. For shoppers, a page without a visible heading looks unfinished and untrustworthy, hurting conversion rates. Accessibility tools and screen readers also rely on the H1 to help visually impaired users navigate your page — missing it creates a legal accessibility risk in many jurisdictions.

See the complete Missing h1 guide for every platform and the full background.

Not sure if your WordPress.org store has this?

Run a free SEOLZ scan — we’ll find missing h1 and every other issue across your whole site.

Scan my site free

Fix missing h1 on another platform