Skip to main content

Accessibility rule: Link without a text alternative, explained

Modified on: Fri, 15 May, 2026 at 3:19 PM

Summary

This check verifies that all links provide an accessible name so assistive technologies can clearly communicate their purpose to users before interaction, helping prevent confusion caused by missing or unclear link descriptions.

Overview

This check makes sure that all types of links that assistive technology users might encounter have an accessible name. Screen reader users need a good text description of the link, they are about to click.

Who is impacted by this?

If an image link is missing an accessible name, screen reader users will not know what the link is supposed to do. In this case, many screen readers will read the URL of the link instead.

Important note

Note: Here we check for the presence of an accessible name. It does not check how suitable the link text is.

How does the check work?

This rule checks that links, such as <a> elements, <area> elements, and elements with a role=link attribute, have an accessible name.

Additional resources

Related Articles

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.