{"id":"ia.link-text","name":"Descriptive link texts","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.link-text","expect":null},"fix":{"steps":[{"action":"Find links with texts such as click here, read more or here.","order":1,"language":null,"code_example":null},{"action":"Change the text so that it names the target page.","order":2,"language":"html","code_example":"<a href=\"/pricing\">See the pricing plans</a>"}],"summary":"Replace generic link texts with texts that name the target.","skill":{"name":"content-semantics","anchor":"ia.link-text"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Link Purpose (In Context)","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html"},{"title":"MDN Anchor element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a"}],"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":"WCAG Link Purpose (In Context)","url":"https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html"},"why":"AI agents use link text to understand navigation and discover related content. Generic text like 'click here' provides no context about where the link leads.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","legacy_id":"3.7","i18n":{"nl":{"name":"Beschrijvende linkteksten","steps":["Zoek links met teksten zoals klik hier, lees meer of hier.","Wijzig de tekst zodat die de doelpagina noemt."],"why":"AI-agents gebruiken linktekst om navigatie te begrijpen en verwante content te vinden. Algemene tekst zoals 'klik hier' zegt niet waar de link heen gaat.","fix_summary":"Vervang algemene linkteksten door teksten die het doel noemen.","verify_expect":null}},"ar_practice_ids":[],"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.link-text","maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}