Skip to Content

H1 heading missing or empty

What it is

The page has no <h1> element, or none of its H1s holds text: each is empty, or holds only an image. The H1 is the main heading of the page: it tells a visitor, a screen reader user and a crawler what the page is about before they read any further.

Why it matters

Screen reader users can jump straight to the main heading to find where the content starts, and W3C’s headings tutorial  treats the rank 1 heading as the most important one on the page. Google lists heading elements among the sources it uses for title links , so without an H1 it has one clear signal fewer. Tools that summarize a page, AI assistants included, are likely to lean on the main heading to name its topic.

How Asky checks it

Asky counts the <h1> elements anywhere in the page’s raw HTML. A heading added by JavaScript is not seen, and neither is text styled as a heading or marked with role="heading". The page is reported when there is no <h1>, or when every H1 is empty after trimming whitespace (an inline SVG’s <title> or <desc> is not text). An empty H1 before one with text is skipped, and several H1s are fine. When the first H1 holds only an image or an SVG with a title, the finding says the H1 is only an image and gives its alt text and where it sits: in the header it is usually the logo.

Reported as a warning with medium severity.

How to fix it

  1. Open the page source (View Source, not the element inspector) and search for <h1.
  2. If there is none, make the page’s main visible heading an <h1>: set the heading’s tag to H1 in Webflow, pick H1 for the heading block in your WordPress editor or page builder, or have your front-end template render the Sanity title as an H1.
  3. If the heading only appears after JavaScript runs, render it on the server or at build time so it is in the HTML.
  4. If an H1 exists but is empty, such as an empty wrapper in the header or a slider, put the page’s heading text in it, or remove it and make the real heading the H1.
  5. If the H1 holds only an image, usually the logo in the site header, change the logo’s wrapper in the template to a <div> or a link and make the page’s main visible heading the H1. If the image is the heading, such as a banner with text set in it, put those words in the H1 as text.

Example

On https://example.com/blog/pricing-guide the article title was styled text, not a heading:

<!-- Before --> <div class="post-title">How to price a SaaS product</div> <!-- After --> <h1 class="post-title">How to price a SaaS product</h1>

← Back to H1 Headings

Last updated on