How to fix landmark one main on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. In your custom theme directory (`app/design/frontend/<Vendor>/<theme>/`), open `Magento_Theme/templates/root.phtml` (or `page/html/main.phtml` for Magento 2's full-page layout).
2. Find the `<div class="page-wrapper">` or equivalent wrapper around `<?= $block->getChildHtml('content') ?>`. Change its tag to `<main class="page-main" id="maincontent">` and update the closing tag.
3. In `default.xml` or `cms_index_index.xml` layout files, ensure the `main` container uses the HTML tag `main` — e.g. `<container name="page.main" htmlTag="main" htmlId="maincontent" htmlClass="page-main">`.
4. Clear the Magento cache: `bin/magento cache:clean` and `bin/magento cache:flush`.
5. Verify on a storefront page with axe DevTools.

What is landmark one main?

Every web page should have exactly one "main" landmark — a special HTML tag (`<main>`) or ARIA role (`role="main"`) that marks the start of the primary content on the page. Think of it like a "skip to content" anchor that is built directly into the page structure. Screen readers and other assistive technologies use landmarks to let users jump between sections (navigation, header, main content, footer) without having to listen to everything in order. The `landmark-one-main` rule specifically checks that your page has one — and only one — such marker.

Without a main landmark, people who use screen readers (blind users, users with motor disabilities who rely on keyboard or switch navigation) must tab through every link, menu item, and banner on your page before they reach any product or content — on every single page load. This is a major usability barrier that can expose your store to accessibility lawsuits under the ADA (US), AODA (Canada), EAA (EU), and similar regulations that require conformance with WCAG 2.1. Fixing it is also a WCAG 2.1 Success Criterion 1.3.6 and 2.4.1 compliance item. Additionally, Google's crawlers and structured-data systems recognise landmark regions, so clear page structure can indirectly support crawl efficiency and rich-result eligibility.

See the complete Landmark one main guide for every platform and the full background.