What this check inspects
Shipwork collects the h1 to h6 elements in document order. It reports no headings at all as an error, no H1 as an error, more than one H1 as a warning, the first heading not being an H1 as informational, level jumps of more than one as warnings, and empty headings as warnings.
What a failure means
A page with no H1 gives crawlers and assistive tech no single statement of its topic. Several H1s split that statement. Skipped levels mean the outline is broken for anyone navigating by heading.
How to fix it
- Give every page exactly one H1 that names what the page is.
- Keep the order sequential: do not jump from H2 to H4 to style a heading differently. Use CSS for size.
- Give each heading text that describes its section rather than a label like More or Details.
- Check that a theme template has not wrapped the product title in an H2 while an unrelated element is the only H1.
A typical failure, worked through
The setupA collection template uses an H1 for the collection name and renders each product tile with its own H1 because the tile component was reused from the product template.
What the check reportsThe check reports more than one H1 on the collection page, and a skipped level where the tile outline jumps from H1 to H3.
The pointOne page, one H1. Product tiles on a listing should use an H2 or H3, reserving the H1 for the page itself.