{"id":"ia.button-names","name":"Button accessible names","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.button-names","expect":null},"fix":{"steps":[{"action":"Add visible text to each button, or an aria-label for icon buttons.","order":1,"language":"html","code_example":"<button type=\"button\" aria-label=\"Close dialog\"><svg aria-hidden=\"true\">...</svg></button>"}],"summary":"Give each button a text or an aria-label.","skill":{"name":"content-semantics","anchor":"ia.button-names"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Name, Role, Value","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"},{"title":"MDN button element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"standard","evidence_source":{"title":"WCAG Name, Role, Value","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"},"why":"AI agents invoke buttons by their accessible name in the accessibility tree. Without a discernible name, an AI agent cannot identify what a button does, making form submission and page interaction impossible.","profiles":["browser_agent_usability"],"score_role":"core","legacy_id":"3.13","i18n":{"nl":{"name":"Toegankelijke namen van knoppen","steps":["Voeg zichtbare tekst toe aan elke knop, of een aria-label voor icoonknoppen."],"why":"AI-agents activeren knoppen via hun toegankelijke naam in de accessibility tree. Zonder naam weet een agent niet wat een knop doet.","fix_summary":"Geef elke knop een tekst of een aria-label.","verify_expect":null}},"ar_practice_ids":[],"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.button-names","maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}