Why Shopify Store Owners need this
You edited your theme to restyle the product title, then installed a review app, and a month later the product page's H1 is gone or doubled. Shopify Help says Online Store 2.0 themes generate the title tag and H1 by default, but custom code or apps can remove them. Nothing looks broken on screen, so nobody notices.
Collection templates have their own version of the problem: the logo, a banner app and the collection title can each be an H1. Collections cannot be nested and meta tags have no built-in templates, so many Shopify SEO fixes need an app or custom Liquid; checking headings does not.
The Heading Structure Analyzer fetches one URL and prints its H1 to H6 outline, followed by three checks: H1 count, H2 usage and heading hierarchy. It reads the HTML your store returns, so you see the markup itself. Run it on one product, one collection and the home page after every theme or app change, and you will know within a minute whether the outline survived.
Shopify Store Owners specific guidance
What to check first on a Shopify store
Start with one URL per template, because product, collection and home page templates are separate runs. Pick a product such as /products/your-handle, a collection such as /collections/your-handle and the home page. Open the Heading Counts cards first: the H1 card turns red when the count is anything other than one. If you changed the theme recently, go to Online Store, Themes, Customize in the Shopify admin and note which sections you added or removed, then compare that list with the outline. The tool reads HTML as served and runs no JavaScript, so a heading an app script adds after load will not show up, and a store behind a storefront password cannot be fetched at all. A clean result says nothing about rankings or indexing.
How to read the three checks
The Checks table has three rows. H1 count reads "N (should be exactly 1)" and is marked bad when N is not 1; that is SeoMods' own criterion, not a Google rule. H2 usage warns when zero H2s exist, which on a product page often means the description is one block of text with no subheadings. Heading hierarchy says either that skipped levels were detected or that there are none, a jump such as H2 to H4. Then read the Document Outline line by line. It includes headings in the header, footer and app or section blocks, so a stray H1 may sit in a newsletter section or a slide-out cart. Each line shows a level chip and the text cut at 120 characters, which is usually enough to recognise the culprit. The result does not tell you which theme file or app produced a heading.
What to fix and in which order
Fix a missing or doubled H1 first, since it is the clearest mismatch. In the theme code editor (Online Store, Themes, the three-dot menu, Edit code), search the section and snippet files for h1 tags. The product title normally belongs in the main product section and the collection title in the main collection section. Change extra h1 tags to a div or an h2 and keep the look with a CSS class. Next repair skipped levels by changing the tag rather than the font size. If an app is the source, look for a heading level option in its settings or ask its support. Duplicate the theme, edit the copy, publish it, then run the live URL again. The tool will not tell you whether the headings contain the right words for shoppers.
Example scenarios
1. Product page lost its H1 after a theme edit
- Situation
- Illustrative example: A store owner replaces the default product title with a custom section that adds a badge beside the name. The new section prints the title inside a div instead of an h1.
- Input
https://your-store.com/products/canvas-tote-bag- Reading the result
- You would typically see the H1 card in red with a count of 0, the H1 count row reading "0 (should be exactly 1)" as bad, and an outline that begins with an H2. Open the main product section in Edit code and restore an h1 around the title. The result does not show what the page title tag looks like.
2. Collection page with three H1s
- Situation
- Illustrative example: A collection template wraps the logo text in an H1 in the header, a banner app adds a promo line as another H1, and the collection title is the third.
- Input
https://your-store.com/collections/linen-shirts- Reading the result
- The H1 card would show 3 in red, and the Document Outline would list three H1 chips: the store name, the promo text and the collection title. Keep the collection title as the H1 and switch the other two to a div or h2. Re-run to confirm the count reads 1.
3. Home page that jumps from H2 to H4
- Situation
- Illustrative example: A featured-collection section prints product names as H4 directly under an H2 section title, because the developer wanted smaller text.
- Input
https://your-store.com/- Reading the result
- Expect one H1, four H2s and six H4s in the counts, with Heading hierarchy reading "Skipped levels detected". Change those H4 tags to H3 and size them with CSS. A passing hierarchy row does not mean the page will rank better.
Common mistakes
- Testing only the home page. Product, collection and page templates are separate files, so a clean home page tells you nothing about /products/ or /collections/ URLs. Run one URL per template.
- Turning every extra H1 into bold text. Removing the tag without checking the outline can leave the page with no H1 at all. Re-run the URL after each edit and confirm the count reads 1.
- Choosing heading tags for font size. Using an H4 because it looks right causes skipped levels. Pick the tag for its place in the outline and set the size with CSS.
- Trusting a preview behind a password. A store with a storefront password or an unpublished theme preview cannot be read by the tool. Check the published URL instead.
- Expecting the outline to explain visibility. The check covers heading structure on one page, not indexing, rankings or sitemap status. A tidy outline is one fix, not a diagnosis.
Frequently asked questions
Why does my Shopify product page have no H1 after I edited my theme?
Online Store 2.0 themes output the product title as an H1 by default, according to Shopify Help, but custom code or an app can remove it. A common cause is replacing the title with a custom block or a Liquid snippet that prints a div. Run the product URL and check the H1 count card; if it reads 0, open Online Store, Themes, Edit code and look in the main product section for the title markup. Restoring an h1 tag there usually fixes it. The tool shows the count, not the cause.
Does Shopify SEO require exactly one H1 per page?
No search engine rule is behind the check. Modern HTML allows more than one H1, and the analyzer marks the count as bad when it is not exactly 1 because that is SeoMods' own criterion: one clear main heading makes templates easier to audit and read. On Shopify the practical point is that a theme normally prints one H1 per template, so a count of 2 or more usually points to a logo, banner or app block worth changing.
How do I find a second H1 on my Shopify collection page?
Run the collection URL, for example /collections/summer-dresses, and open the Document Outline. Every heading appears in page order with a level chip, so look for a second H1 chip and read its text. If it says your store name, the logo in the header is wrapped in an H1; if it is a promo line, a banner section or app block did it. Then search the theme's header section and other section files for h1. The outline tells you the text, not the file.
Can this check tell me why my Shopify store is not showing on Google?
No. It reads headings on one page, so it cannot see indexing status, rankings, sitemap submission or robots.txt.liquid rules. A missing H1 is a structure problem you can fix in minutes, but a store that does not appear on Google needs different checks, such as Google Search Console and your sitemap at /sitemap.xml, which Shopify generates automatically. Use the outline to rule out one cause of weak page structure, not to diagnose visibility.
Do Shopify apps that add headings show up in the heading outline?
It depends on how the app writes them. The analyzer reads the HTML as served and runs no JavaScript, so headings that an app injects after the page loads will not appear. Headings the app prints through Liquid into the page source do appear, including those inside app blocks, the header and the footer. If a review widget's heading is missing from the outline, that does not mean it is absent for visitors. Use your browser's element inspector to confirm.
Reference: The Ahrefs beginner guide to Shopify SEO notes that Shopify does not support templated title and meta description tags out of the box, so bulk meta tags need third-party apps.