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

Steps for Adobe Commerce (Magento)

1. **Product pages:** In your theme, locate `app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/product/view/overview.phtml` (or the relevant `.phtml` for the title). Confirm the product name is rendered inside `<h1 class="page-title">…</h1>`. The default Luma theme already does this — if yours does not, override the template in your custom theme.
2. **Category pages:** Check `app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/category/view.phtml` and ensure `$block->getLayer()->getCurrentCategory()->getName()` is wrapped in `<h1>`.
3. **CMS pages:** Go to Content → Pages → edit the page → expand 'Content' → switch to HTML editor and add `<h1>Your Page Title</h1>` as the first heading.
4. **Layout XML override:** Alternatively, use `catalog_product_view.xml` / `catalog_category_view.xml` layout XML files to inject or correct the heading block without touching `.phtml` files.
5. Flush cache (System → Cache Management → Flush Magento Cache) and verify on the frontend.

<h1>Women's Running Shoes</h1>

What is page has heading one?

Every web page should have exactly one level-one heading — an `<h1>` tag — that clearly names the main subject of that page (e.g. "Women's Running Shoes" on a category page, or a product name on a product detail page). Think of it as the title written on the page itself, separate from the browser tab title. When this heading is missing, assistive technologies like screen readers have no clear starting point to announce to a visitor, and the page's content hierarchy is broken.

**Accessibility & legal risk:** Screen reader users — including shoppers with visual impairments — rely on the `<h1>` to understand where they are and navigate the page quickly. Missing it creates a poor, disorienting experience and can expose your store to accessibility-related legal complaints in jurisdictions where WCAG compliance is expected (e.g. ADA in the US, EN 301 549 in the EU). **SEO & rankings:** Search engine crawlers treat the `<h1>` as the strongest on-page signal for what a page is about. A missing `<h1>` weakens keyword relevance signals, which can suppress organic rankings — especially on high-value category, product, and landing pages. **Conversions:** A clear, visible page heading also reassures human shoppers they've landed in the right place, reducing bounce rates and improving confidence to buy.

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