Image Alternatives Available
Group: images-and-media • Guideline: image-alternatives
Summary in Plain English
Every image that is not decorative has a text alternative.
Why It Matters
Without one, a screen reader user gets a filename or silence where the content is - and if the image is a link or a control, may not be able to use it at all.
Test Procedure from the W3C Draft
Quoted from the provision's informative document, informative/guidelines/images-and-media/image-alternatives/image-alternatives-available.md. It is the group's own procedure, not an editorial testing guide.
Provide a text alternative for the image in a way that conveys the equivalent meaning or content thatโs displayed visually.
(General) Equivalent text alternative
Procedure
For each non-decorative image:
- Remove, hide, or mask the image.
- Replace it with the text alternative.
- Check that the meaningful content in the image is described by the text alternative.
- If the image includes words that are important to understanding the content, check that those words are included in the text alternative.
Expected results
- #3 is true.
- #4 is also true, if the image includes words that are important to understanding the content.
W3C Working Group Status
The draft records no open editors' notes on this provision.
W3C Threads on This Provision
7 GitHub threads carrying 23 comments, fetched from w3c/wcag3 by the tracker. Titles, numbers and states are the threads' own.
What the Argument Is About
Whether "available" means available to everyone or only through assistive technology, and whether "equivalent" is a definition problem the standard can fix or a practice problem it cannot.
Positions taken in the thread
MarcHaunschild opened #191 arguing there is no icon everyone understands, and that an aria-label serves only screen reader users โ the sighted majority, people who do not read the Latin alphabet, and speech-input users get nothing. His example is the GitHub editor toolbar, where a large A beside a small A could equally mean resize text; it actually means add header text, and he says he would never have guessed. He reports Germany's BITV-Test once required textual descriptions for icons and dropped the requirement to align with WCAG, which he treats as a regression. alastc drafted the requirement as "a visible text equivalent for icons is available" with icon defined as a non-text representation of a function or discrete piece of information, such as a printer for print or a green tick for complete; MarcHaunschild accepted it and asked for a carve-out, "unless it is essential to be without text", for cases such as a game where guessing the shape is the point.
alastc reported in March 2020 that DavidMacDonald's proposal was worked through in the group and put to a member survey, and that coverage broke down across four scenarios: active and inactive icons, on mouse and on touchscreen. A hover tooltip handles the mouse cases cleanly, but on a touchscreen the user cannot reach the text without activating the control or relying on a flaky double tap, and forcing visible labels into a toolbar destroys the toolbar's purpose. LJWatson cautioned separately against title attributes and the SVG title element becoming the recommended route, since those tooltips are not dismissable; awkawk noted 1.4.13's exception for user-agent-controlled presentation makes them technically permissible, and LJWatson accepted the exemption while maintaining the practice should not be encouraged. detlevhfischer pushed back on the related proposal to extend Label in Name to graphical buttons, asking what a speech-input user would actually say โ "click i", "click italics" โ and pointing to the existing symbolic-text-characters exception as the right answer.
His #370 argument is that "equivalent" has been so weakly defined that a file name passes in practice: "dog32234.jpg" tells you nothing about breed, setting, activity or the rhetorical reason the image was chosen, and he demonstrates the gap by asking whether readers pictured a French Bulldog on a Hawaiian beach or a Rottweiler on a grassy field. He cites Perkins at under 1 percent of the web compliant, AudioEye at roughly 3 percent and WebAIM at 4 percent, and argues Instagram's billion-plus uploads a day are being pushed toward GenAI descriptions of the form "Might be a man, wearing glasses". He wants equivalence defined against the academic literature on information exchange and extended explicitly to maps, charts, tables, data visualizations and descriptions of people, rather than a title plus a one-sentence overview. In #371 he makes the parallel terminology case: "image" excludes maps, charts and data visualizations in most people's minds, and WCAG should adopt static Audio Description, the term used by the American Council of the Blind, the American Foundation for the Blind, RNIB, the World Blind Union, the American Alliance of Museums and the US National Park Service, over image description, which is largely a computer-science coinage.
patrickhlauke's first reply is a flat correction: "dog32234.jpg" does not pass, it fails 1.1.1 as an inappropriate text alternative. TestPartners argues authors misusing text alternatives is not a loophole โ testers frequently do not test the criterion correctly, automated tools cannot yet judge appropriateness, and the root causes are education and authoring platforms that do not help; WCAG 3 cannot and will not fix that. brett-oppegaard called that a defeatist attitude and proposed that WCAG 3 tighten its definitions, add more scaffolding, and create more metrics and benchmarks to close the gap between intent and practice. He adds a newer structural cause: organizations now store images in digital asset management systems with the alt text attached, so the text is written with no knowledge of the context it will be used in, which is why it defaults to a literal description of the image contents. yatil makes the division-of-labour point โ W3C defines conformance, laws enforce it, and under the European Accessibility Act member states must stand up agencies with fines behind EN 301 549's reference to WCAG 2.1.
In #272 he asks the group to revisit his proposal "Meaningful images have a text alternative" in place of the current goal that users have equivalent alternatives. His grounds are that decades of evidence show equivalence at scale does not work โ he cites WebAIM's finding that nearly a third of images on popular home pages have missing, questionable or repetitive alternative text โ and that even where alt text exists there is no agreement on what an equivalent is: ask ten experts and you get ten answers, with far wider spread in the wild. He frames the fix as inter-rater reliability, pointing to slides he presented to the working group three years earlier, and argues a meaningfulness test is both more scalable now and better positioned for changes in technology.
#499 takes the draft sentence on its own terms: "Equivalent text alternatives are available for images that convey content" does not say what the alternative must be equivalent to. He notes that someone carrying WCAG 2 knowledge assumes the intent is the purpose of the image, but read cold the wording points at the content of the image instead โ under which "House icon" would be correct and "home" would not.
Agreed
- The state of alt text in the wild is poor. brett-oppegaard and mbgower cite overlapping evidence for it and TestPartners does not dispute it; they differ on whether the standard is implicated in the cause.
- patrickhlauke's correction that a file-name alt already fails WCAG 2.x 1.1.1 was echoed by yatil and TestPartners. brett-oppegaard did not dispute the normative reading but maintained that file names and one-line alt text are what he finds in practice, and turned to enforcement and interpretation.
- yatil's account of where the buck stops โ W3C sets the standard, civil rights law and the EAA enforce it, and W3C has neither budget nor intent to review billions of sites โ was accepted by brett-oppegaard, who redirected to the DOJ Title II rule.
- TestPartners' digital-asset-management argument is unrebutted and brett-oppegaard endorsed the underlying problem, agreeing descriptions should be crafted per use and logged so a recontextualization trail exists, while conceding that would require a major shift in archiving practice.
- Nobody defended the title attribute or the SVG title element as the technique to recommend, even after awkawk established it is permissible under 1.4.13's user-agent exception.
Still open
- Whether a visible text equivalent for icons should be required at all. MarcHaunschild's #191 has had no substantive comment since alastc reported the survey outcome in March 2020, and no one has proposed a touchscreen mechanism since.
- Whether "equivalent" is measured against the image's content or its purpose. WilcoFiers raised it in #499 in January 2026 and the issue has no replies.
- Whether the provision must say something specific about maps, charts, tables and data visualizations rather than treating them as images. brett-oppegaard asked for it in #370 and it was not taken up in a thread that turned to enforcement instead.
- Whether "image" and "alt text" should be retired in favour of static Audio Description. brett-oppegaard's #371 has been open since September 2025 with zero comments, so the terminology argument the decorative-images threads defer to here has in fact never been answered.
- Whether mbgower's meaningfulness framing replaces the equivalence goal. He asked twice in July 2025 and offered to walk the group through it; no one has responded on the issue.
- Whether WCAG should say anything about over-specifying attributes in a description. rusteinberg's #251 raises the risk of an author writing "African American man working on his computer" about someone who is neither, and suggests "Man working on his computer" instead; MakotoUeki, then the Alt Text subgroup lead, asked which writing guide the advice came from in November 2021 and the thread stopped there.
- MarcHaunschild's "unless it is essential to be without text" exception, and detlevhfischer's question of what a speech-input user would say for a graphical button, were both raised once and never examined.
Note
This provision is discussed far less than its filing count suggests: 7 threads and 23 comments, of which #191 (11) and #370 (8) account for most of the exchange and three others (#251, #371, #499) are effectively unanswered. #191 predates WCAG 3's provision structure by six years, and the substantive record for it โ the acceptance survey alastc worked from โ sits behind a W3C member-only link, so the reasoning for dropping the icon requirement is not publicly readable here. sydneycolemanfromgoogle's #518, on the decorative versus purely decorative distinction, is labelled against this provision but adampage marked it as a duplicate of #466 (it remains open), which moves that whole argument into the decorative-images-hidden record. As there, brett-oppegaard participates by email, so his comments arrive with quoted reply chains attached.
- #191 Description for Icons open 11 comments · updated 2026-05-02
- #251 Question about specifics in alternative text open 1 comment · updated 2026-05-02
- #272 Requirements: Image alternatives open 2 comments · updated 2026-04-02
- #370 Equivalence in "image alternatives" 2.1 Image and media alternatives Developing Guideline 2.1.1 Image alternatives open 8 comments · updated 2026-09-10
- #371 "image" as the label in "image alternatives" 2.1 Image and media alternatives Developing Guideline 2.1.1 Image alternatives open 0 comments · updated 2026-04-01
- #499 What does a text alternative need to be equivalent to? open 0 comments · updated 2026-03-27
- #518 [Image alternatives] โdecorativeโ and โpurely decorativeโ distinction not useful open 1 comment · updated 2026-03-29
WCAG 2.2 Criteria That Map Here
From this site's reviewed WCAG 2.2 → WCAG 3 map. The map is an interpretation, not a W3C mapping: W3C has not published one yet.
W3C Raw Source Text
Verbatim from guidelines/groups/images-and-media/image-alternatives/image-alternatives-available.md · informative document: informative/guidelines/images-and-media/image-alternatives/image-alternatives-available.md
Text alternatives are available for non-decorative images.