Missing H1

Topic summary

A Shopify store owner is encountering “Missing H1” errors on collection pages when using Screaming Frog, despite believing they’ve added H1 tags correctly.

Root Cause Identified:

  • Multiple users examined the store’s source code and confirmed H1 tags are genuinely missing from collection pages
  • The collection title is currently wrapped in <h2> tags instead of <h1>
  • Manually adding H1s within the description field doesn’t create proper page-level headings for SEO purposes

Proposed Solutions:

  1. Edit theme code in sections/main-collection-banner.liquid or similar files
  2. Change <h2>{{ collection.title }}</h2> to <h1>{{ collection.title }}</h1>
  3. Alternatively, add conditional H1 code to theme.liquid file between <body> tags

Current Status:

  • The store owner attempted the suggested code fix but reports Screaming Frog still shows missing H1s
  • A support user is offering to investigate further to verify correct code implementation
  • Issue remains unresolved and requires additional troubleshooting
Summarized with AI on October 28. AI used: claude-sonnet-4-5-20250929.

So using screaming frog and it says basically all my collection category’s are missing H1 , I thought going in and adding the H1 and description would fix this I even checked the HTML and it looks fine why’s this the case still

1 Like

Hi @JGBowie

can you share your store url?

https://softbeginnings.au/

Hello @JGBowie

you’re seeing “Missing H1” errors for your collection pages in Screaming Frog even though you added H1s and descriptions manually in Shopify. You even checked the HTML, but it’s still showing missing.

Common reasons for this in Shopify:

  1. Theme might not render the H1 from description:
    Even if you add a heading inside the description editor, Shopify by default does not wrap collection titles in an H1 unless the theme explicitly does. Most themes render collection names in

    or even plain
    by mistake.

  2. Manual H1 inside the description isn’t counted:
    If you manually added an

    inside the description field, search engines and crawlers sometimes ignore it if the page’s main title itself isn’t in an

    tag outside of the rich text editor area.

  3. Theme design missing H1 for SEO:
    Some Shopify themes simply forget to wrap the collection name properly. It looks right visually, but semantically, for SEO, it’s wrong.

Here’s what I found immediately:

. On your collection pages (e.g., Baby Blankets Collection), the collection title (“Baby Blankets”) is rendered inside an

, not an

.

. No

tag exists at all on the page.

. Even if you added an

inside the description, that’s not the proper page-level heading expected.

Example from your source code:

## Baby Blankets

There is no real

.

That’s why Screaming Frog says “Missing H1” — because the actual main title isn’t wrapped in

, it’s in

.

How to properly fix it:
We need to edit your Shopify theme code so that the collection name/title uses an

.

Here’s the step-by-step fix:

  1. Go to: Online Store > Themes > … > Edit code

  2. Find the file:

. Typically: sections/main-collection-banner.liquid

. Or sometimes: sections/collection-template.liquid

  1. Look for the code that outputs the title
    You’ll see something like:
## {{ collection.title }}
  1. Change that

    to

    :

# {{ collection.title }}
  1. Save and refresh your collection pages.

After this, Screaming Frog will pick it up correctly, and your pages will have a proper

for SEO.

Thank you :blush:

Nope in the code area,

is listed not a

Hi @JGBowie

Concerning the H1 missing issue, we can check if H1 is missing indeed or not from your website’s Collection source code page. After searching with <h1 under source code page, it is indeed missing H1.

Therefore, to resolve this issue, you can add the following H1 code for Collection pages between and in the theme.liquid file after accessing Shopify store backend. After adding, this issue should be fine soon.

{% if template.name =='collection' %}
# {{collection.title}}
{% endif %}

Tried this screaming frog is still showing they are missing

May I know if you added the code correctly? If so, we can talk more about the issue details on your store if still not working.