How to fix page has heading one on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. For product pages: the product name is rendered by app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/product/view/details.phtml (or the parent theme equivalent). Confirm the name is wrapped in <h1 class='page-title'>.
2. For CMS pages: go to Content → Pages, open the page, and in the Content editor (PageBuilder or standard WYSIWYG) add a Heading row with H1 type, or wrap the title text in a Heading 1 widget.
3. For category pages: the category name is typically output as <h1> in app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/category/view.phtml — verify and correct if needed.
4. If using a custom theme, create an override in your theme folder rather than editing core files.
5. Clear the Magento cache (System → Cache Management → Flush Magento Cache) and verify the rendered HTML with browser DevTools.

What is page has heading one?

Every web page should have exactly one top-level heading — an `<h1>` — that clearly describes what the page is about. Think of it as the title of a chapter in a book: it tells both visitors and software (screen readers, search engines) what the main subject is before they read anything else. If a page is missing an `<h1>`, or if the text that looks like a big bold title is actually styled with CSS rather than a true heading tag, the page fails this requirement. The `<h1>` doesn't have to be visually the largest text on the page, but it does have to exist in the HTML as an actual heading element.

Screen-reader users — an estimated 7–8 million people in the US alone — navigate pages by jumping between headings, and the `<h1>` is their first orientation point. Without it, they land on the page with no clear signal about where they are, creating a frustrating or unusable experience. From an SEO standpoint, the `<h1>` is one of the strongest on-page signals search engines use to understand relevance; missing it can reduce keyword rankings and organic traffic. In jurisdictions covered by the ADA (USA), EN 301 549 (EU), or the UK Equality Act, inaccessible pages carry real legal risk — accessibility lawsuits against online retailers have risen every year since 2017. Finally, a clear, prominent page title improves user confidence and reduces bounce rates, directly protecting conversion rates.

See the complete Page has heading one guide for every platform and the full background.