Design/UX #26093
openMissing or non-descriptive alt text on image links
0%
Description
I noticed that a few main Commons pages have image links with missing or non-descriptive alt text, potentially making it difficult for users of screen readers to determine where those elements lead. On the Activity page, for instance, avatar image links use “Profile Photo” even though they lead to different users or groups. The adjacent name provides some context but I wonder whether we could also include the person’s or group’s listed name in the avatar’s alt text.
More importantly some of the linked images on the homepage, About, and other pages seem to have empty alt text. A couple examples include Natural Sciences Open Educational Resources under Featured Sites on the homepage and the image link for Core Books on the About page. Pages I came across where this was an issue are also linked below:
Firefox inspector referenced the following resource as part of the accessibility check in case it's any helpful: https://developer.mozilla.org/en-US/docs/Web/Accessibility/Guides/Understanding_WCAG/Text_labels_and_names?utm_source=devtools&utm_medium=a11y-panel-checks-text-label&utm_campaign=default#Interactive_elements_must_be_labeled
Files
Related issues
Updated by Zachary Muhlbauer 8 days ago
- File deleted (
Screenshot 2026-11-13 at 12.46.18 PM.png)
Updated by Raymond Hoh 5 days ago
Thanks for the detailed write-up, Zach.
As part of the accessibility audit by Vispero in #25126, they actually mentioned that decorative images, such as the avatar photos, are decorative and do not convey information, and therefore, their alt text should be removed. This is what they stated:
Instances of decorative images were found that are not hidden from screen reader users. Images that are decorative and do not convey any meaningful information to users must be hidden from assistive technologies. If they aren't hidden, screen readers may:
- announce the image's filename;
- announce the image as ""graphic"", ""image"", or similar;
- announce a description generated by AI.All of these outcomes are undesirable and unlikely to be helpful to users.
Use an empty string as text alternative
alt="". This will ensure that the image is not announced by assistive technologies.
On the Activity page, for instance, avatar image links use “Profile Photo” even though they lead to different users or groups. The adjacent name provides some context but I wonder whether we could also include the person’s or group’s listed name in the avatar’s alt text.
Thanks for catching this, Zach. For the reasons Vispero mentioned above about decorative images, I think we might have to consider removing the alt text here as well.
Updated by Raymond Hoh 5 days ago
- Related to Bug #25126: VPAT Initial Report added
Updated by Boone Gorges 4 days ago
Thanks for catching this, Zach. For the reasons Vispero mentioned above about decorative images, I think we might have to consider removing the alt text here as well.
Agreed - I think the best practice here would be remove the alt text so that screen readers simply ignore the avatars.
The images that appear in the content of posts (such as About and Accessibility) should have their alt text either improved or removed. This'll have to be done manually. I'm CCing Colin here so that he or a member of the Community Team can have a look at this.