{"id":"ia.heading-hierarchy","name":"Heading hierarchy","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.heading-hierarchy","expect":null},"fix":{"steps":[{"action":"Give each page one h1 that names the main topic.","order":1,"language":null,"code_example":null},{"action":"Use h2 for sections and h3 for subsections, without skipped levels.","order":2,"language":"html","code_example":"<h1>Pricing</h1>\n<h2>Plans</h2>\n<h3>Team plan</h3>"}],"summary":"Use one h1 and do not skip heading levels.","skill":{"name":"content-semantics","anchor":"ia.heading-hierarchy"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN Heading Elements","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements"},{"title":"W3C Using h1-h6 to identify headings","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Techniques/html/H42"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-03","url":"https://www.agentready.org/#read"},"why":"AI agents use headings to build a content outline and determine topic hierarchy. A clear h1→h2→h3 structure helps AI systems extract and summarize your content accurately.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","legacy_id":"3.2","i18n":{"nl":{"name":"Kophierarchie","steps":["Geef elke pagina een h1 die het hoofdonderwerp noemt.","Gebruik h2 voor secties en h3 voor subsecties, zonder overgeslagen niveaus."],"why":"AI-agents gebruiken koppen om een outline te maken en de hierarchie van onderwerpen te bepalen. Een duidelijke h1-h2-h3-structuur helpt AI-systemen om content correct samen te vatten.","fix_summary":"Gebruik een h1 en sla geen kopniveaus over.","verify_expect":null}},"ar_practice_ids":["AR-READ-03"],"strength":"MUST","ar_mapping":"partial","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.heading-hierarchy","maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}