How to fix landmark one main on Magento Open Source

Steps for Magento Open Source

1. Same process as Adobe Commerce: edit your theme's layout XML (`default.xml`) to set `htmlTag="main"` on the primary content container, and update the corresponding `.phtml` template.
2. Run `bin/magento cache:clean` after changes.
3. Verify 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.