{"canonical_url":"https://engineer.company/glossary/landmark/","content_markdown":"# Landmark\n\n## What it is\n\nA landmark, also called a landmark region or an ARIA landmark, is a part of a web page that the\nmarkup names by its purpose, such as the site header, the main content, the navigation or the\nfooter, so that assistive technology can list those parts and move straight to any one of them. A\npage usually has several landmarks, and together they describe its layout to someone who never sees\nthe layout.\n\nWAI-ARIA 1.2 defines eight landmark roles: `banner`, `navigation`, `main`, `complementary`,\n`contentinfo`, `search`, `form` and `region`. A ninth, `landmark` itself, is the abstract parent in\nthe specification's role model, and authors are told not to use it. Most pages never need the `role`\nattribute to get the others, because HTML elements carry them already:\n\n- `main` is the `main` landmark, and `nav` is a `navigation` landmark.\n- `header` and `footer` become `banner` and `contentinfo` only when they belong to the page as a\n  whole. Placed inside an `article`, a `section` or `main`, they are ordinary page structure and not\n  landmarks at all.\n- `aside` is `complementary` at the top level of the page or inside `main`. Inside other sectioning\n  content it counts only when it has a name.\n- `section` becomes a `region` landmark only when it has an accessible name, from `aria-label` or\n  from a heading referenced with `aria-labelledby`. A nameless `section` is just a group.\n- `form` maps to the `form` role, and the specification requires authors to label it. The newer\n  `search` element maps to `search`.\n\nThe specification asks assistive technologies to let people reach these regions quickly, and screen\nreaders do. In NVDA, `D` moves to the next landmark and the elements list shows all of them at once;\nVoiceOver's rotor has a landmarks list of its own. A user arriving on a page can open that list,\nhear that there is a banner, a navigation, a main region and a footer, and know the page's shape\nbefore reading a word of it.\n\n## Why it matters\n\nThe decision behind landmarks is whether every part of a page sits somewhere a listener can name and\nreach. On a typical page most of the content is repeated: the header, the menu, the footer and often\na sidebar are the same on every page of the site, and the part that is new sits somewhere in the\nmiddle. A sighted visitor's eyes go straight there. Without landmarks, a screen reader user has to\nlisten past the same header and menu on every page, or guess how many headings to skip.\n\nWCAG's own technique for landmarks, ARIA11, is listed as a sufficient way to meet three success\ncriteria. One of them asks for a way to skip blocks of content repeated across pages; another asks\nthat the structure a sighted reader takes from the layout is also available to software. The cost of\nmeeting them this way is small when the page is built from `header`, `nav`, `main` and `footer` in\nthe first place: the semantics come with the element, and there is nothing extra to maintain.\nRetrofitting landmarks into a layout made of nested `div` elements costs more, but the work is\nmostly mechanical.\n\nThere are two limits worth knowing. The first is that the specification leaves landmark navigation\noptional for mainstream browsers, so a keyboard user without a screen reader usually gets nothing\nfrom landmarks on their own, and a visible skip link still earns its place. The second is that more\nlandmarks do not make a page easier to use. Each one is an entry in a list somebody has to hear, and\na page where every block is a named region reads like a table of contents fifty lines long. The\nspecification keeps `region` for content important enough to appear in a summary of the page, and\nasks authors to use it only when none of the other roles describes the purpose.\n\n## What it looks like in practice\n\nThe brand mark on every inner page sat outside every landmark, and nothing on screen gave that away,\nwhich is typical of a defect only the structure can show. It came to light during the work to\n[take the whole site to WCAG 2.2 level AA](/portfolio/a-site-that-meets-the-accessibility-standard/).\nThe automation runs an accessibility rule engine with its best-practice rules enabled, not only the\nconformance ones, which is a thirty-rule difference, and one of the extra rules failed the moment it\nwas switched on.\n\nThe guards explain how it had gone unnoticed. Among\n[eleven defects the browser had called healthy](/portfolio/the-accessibility-faults-your-checker-misses/),\ntwo were in the guards rather than the pages, and one of those was that the rule engine had been\nrunning seventy of its hundred and five rules. The rule that would have caught the missing landmark\nwas simply not in the set. The lesson is short: a rule set that does not contain the rule cannot\nenforce it.\n\nOutside the main site, the landing page in front of the\n[company's own git forge](/portfolio/your-code-on-your-own-hardware/) had been a\nhand-maintained copy of the main site's design, and every difference ever found between the two\nturned out to be an accident rather than a decision. One of the five was that no page had a main\nlandmark or a top-level heading, and not one of the five was visible in a screenshot. The copy was\ndeleted, and the landing page is now built by the main site's own templates, so it inherits the same\nstructure instead of imitating it.\n\n## Where it goes wrong\n\nLandmark mistakes are silent on screen and plain to hear in a screen reader. These are the common\nones.\n\n**Content lands outside every landmark.** A logo, a cookie notice or a language switcher is placed\nbefore the `header` or after the `footer`, and a listener moving by landmark skips past it. The axe\nrule `region` reports any content not contained by a landmark, but it is tagged as best practice\nrather than as a WCAG failure, so a run limited to the WCAG tags never executes it. Turn the\nbest-practice rules on, and move the stray element inside the landmark it belongs to.\n\n**The same role appears twice with the same name.** Two `nav` elements, one in the header and one in\nthe footer, both announce as “navigation”, and the listener has to guess which is which. Give each a\nshort, distinct label with `aria-label` or `aria-labelledby`, and leave the role out of the label: a\nnavigation labelled “Site navigation” is read as “Site navigation navigation”.\n\n**A second main or banner appears.** A `div` is given `role=\"main\"` or `role=\"banner\"` to make a\ncomponent feel important, or a template wraps an inner page in a `main` of its own, and the page now\nannounces two of a role it should have once. The specification asks for at most one `banner`, one\n`main` and one `contentinfo` per page, and axe has a rule for each. Check the landmark list after\nevery layout change, and let the native elements carry the roles wherever they can.\n\n**Every block becomes a region.** A component library gives every `section` an `aria-label` by\ndefault, and the landmark list fills up with card titles. Name a `section` only when a reader would\nwant to jump to it from anywhere on the page.\n\nA page shaped like the sketch below gives a listener five stops, each one distinct:\n\n```html\n\u003cheader\u003e\u003c!-- logo, search --\u003e\u003c/header\u003e\n\u003cnav aria-label=\"Site\"\u003e\u003c!-- menu --\u003e\u003c/nav\u003e\n\u003cmain\u003e\n    \u003ch1\u003ePrices\u003c/h1\u003e\n    \u003csection aria-labelledby=\"hosting\"\u003e\n        \u003ch2 id=\"hosting\"\u003eHosting\u003c/h2\u003e\n    \u003c/section\u003e\n\u003c/main\u003e\n\u003cfooter\u003e\u003c!-- contact, legal --\u003e\u003c/footer\u003e\n```\n\n## Further reading\n\n- [WAI-ARIA 1.2: Landmark Roles](https://www.w3.org/TR/wai-aria-1.2/#landmark_roles) — the eight\n  roles, what each one is for, and which ones must carry a label.\n- [Landmark Regions](https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/) — the W3C\n  authoring guide on choosing roles, labelling repeated landmarks and keeping all content inside\n  one.\n- [HTML Accessibility API Mappings 1.0](https://www.w3.org/TR/html-aam-1.0/) — which HTML elements\n  become which roles, including when `header`, `footer`, `aside` and `section` count as landmarks.\n- [ARIA11: Using ARIA landmarks to identify regions of a page](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA11)\n  — the WCAG technique, with its test procedure and the success criteria it meets.\n\n\u003chttps://engineer.company/glossary/landmark/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Which elements become landmarks, how screen reader users move between them, and how content ends up outside every landmark without anyone seeing it.","formats":{"gemtext":"https://engineer.company/glossary/landmark/index.gmi","gopher":"https://engineer.company/glossary/landmark/gophermap","html":"https://engineer.company/glossary/landmark/","json":"https://engineer.company/glossary/landmark/index.json","markdown":"https://engineer.company/glossary/landmark/index.md","pdf":"https://engineer.company/glossary/landmark/index.pdf"},"kind":"page","language":"en","title":"What is a landmark?","url":"https://engineer.company/glossary/landmark/","version":1}