Feature - Linked image with alternative text
- WAVE Category: Feature
- WAVE ACCESSIBILITY PATTERN: Linked image with alternative text
Page Content Status
- WAVE Tool Reference text
- Example of a DOM Snippet Generated From WAVE Tool
- Screenshots of Accessibility Pattern in Use
- Credits/Authors
WAVE Tool Reference
Click to see WAVE Tool Reference
This content added 2026-04-27. Check for updated guidance at: https://wave.webaim.org/api/docs?format=html#alt_link
WAVE Category
Features
WAVE Error
Linked image with alternative text
What It Means
Alternative text is present for an image that is within a link.
Why It Matters
Including appropriate alternative text on an image within a link ensures that the function and purpose of the link and the content of the image is available to screen reader users or when images are unavailable.
What To Do
Ensure that the alternative text presents the content of the image and/or the function of the link. If the full content and function of the link is presented in text within the link (an image and a text caption both within the same link, for example), then the image should generally be given empty/null alternative text (alt="") to avoid redundancy.
The Algorithm... in English
An image element has non-empty alternative text, is within a link, and no other text (or images with alternative text) is present within the link.
Standards and Guidelines
Example of a DOM Snippet Generated From WAVE Tool
Screenshots of Accessibility Pattern in Use
1. Descriptive Title for Screenshot Set 1
Description/text for image
[INSERT IMAGE HERE]
Credits/Authors
- @MissBrandyLea
- [INCLUDE Contributor 2]
- [INCLUDE Contributor N]