- Library
- Communication & Influence
- Cross-Cultural & Inclusive Communication
- Accessibility & A11y Patterns
- Alt Text for Images
Mental model
Alt Text for Images
Text alternatives that communicate an image’s essential information or function according to its purpose on the page.
Discover
Alt text communicates an image’s information or function in words. A screen reader can present those words as speech or Braille. Before writing alt text, what should you decide first?
Choose the first step
Learn how to choose text alternatives based on an image’s purpose.
Understand
Understand
Alt text is a text alternative that communicates an image’s information or function. A screen reader can present this text as speech or Braille. The right wording depends on why the image appears on the page. Pick one image and identify what it contributes.
Full explanation
Full explanation
Start by deciding whether an image conveys important information, performs a function, or serves only as decoration. For informative images, provide a short description conveying the essential information. Context determines which details matter: WAI explains that a bird’s exact appearance may matter more on a website about birds than on one about parks. Images Tutorial
For functional images used as links or buttons, describe the destination or action. In a hypothetical example, a document icon is the only content of a link to an employee handbook in PDF, a document file format. “Employee handbook (PDF)” identifies the destination more clearly than “PDF document icon,” which describes its appearance.
For an image whose only purpose is visual decoration, provide an empty text alternative. In page code, the alt attribute supplies an image’s alternative text; alt="" gives it an empty value. In a hypothetical travel blog, a sunset photo used only as decoration would receive this empty value. A caption alone does not establish that an image is decorative: first determine whether the image contributes information important to understanding the page.
A short description is not sufficient for every image. For complex images such as graphs and diagrams, provide a complete text equivalent of the data or detailed information. WAI also advises avoiding readable text within images unless the image is a logo; when images of text are used, their text alternatives should contain the same words. These decisions depend on the author understanding the image’s usage, context, and content. The tutorial provides implementation guidance, not experimental proof or a guarantee of legal compliance. Images Tutorial
Research
Research
- Official guidance: WAI distinguishes informative, decorative, and functional images. Their text alternatives respectively convey essential information, use an empty value for decoration alone, or describe the link or button’s function [1]
- Official guidance: Complex images need a complete text equivalent of their data or detailed information. The tutorial does not impose a universal one-sentence limit on text alternatives [1]
- Scope of guidance: The tutorial combines resources concerning Non-text Content at Level A, Images of Text at Level AA, and Images of Text (No Exception) at Level AAA. These are different WCAG conformance levels; the overview does not reproduce each criterion’s full conditions and exceptions [1]
Limitations
Limitations
The supplied source is official implementation guidance, not an experiment measuring navigation, comprehension, or behavioral effects. It does not establish universal benefits or guarantee legal compliance. Its category summaries should not be treated as the complete requirements of WCAG, the Web Content Accessibility Guidelines.
The old “Henry et al. (2014)” citation and its claimed navigation finding are unverified by the supplied evidence and have been removed. WAI’s Images Tutorial replaces that attribution as the guidance source. The earlier 2024 date assigned to the tutorial is also removed; the supplied bibliography records its year as unknown. The handbook and sunset examples are hypothetical applications of the guidance.
Try it
Synthesize
Choose a pattern from the guide, then pick an action to try with it.
Which pattern stands out?
What will you try?
Choose a pattern above to select an action.
Sources
Sources
- [1] Images TutorialW3C Web Accessibility Initiative
Try it
Check your understanding
In a hypothetical travel blog, a beach-sunset photo serves only as visual decoration and conveys no information important to understanding the page. Which text alternative matches WAI guidance?
Show the guide's explanation
Answer: "" (empty alt attribute)
WAI recommends an empty text alternative when an image’s only purpose is decoration. The stated purpose establishes the answer; the presence of a caption alone would not establish that the image is decorative.
In a hypothetical webpage, a document icon is the only content of a link to a downloadable PDF employee handbook. Which text alternative best identifies the destination?
Show the guide's explanation
Answer: "Employee handbook (PDF)"
For an image used as a link, describe its function or destination. This option identifies the specific document and its format; the other options describe appearance or leave the destination unspecified.
A hypothetical webpage includes a photo that is neither a link nor a button. Before writing its alt text, what should you do first?
Show the guide's explanation
Answer: Decide whether the image conveys important content or is decorative
The image’s purpose and context determine its text alternative. An informative photo needs its essential information conveyed in text; a photo used only as decoration receives an empty text alternative.
Keep exploring
Find another idea for the decision in front of you.
The complete Reframo library is free to read. Explore another guide whenever you are ready.