Mental model
Alt Text for Images
A text description for images that makes visual content accessible to screen reader users and improves search engine optimization.
Discover
When you add an image to a website, there's a specific sequence you should follow to make it accessible to everyone. What's the first step?
Put these steps in order
You'll learn a simple framework for writing alt text that works for any image.
Understand
Understand
Alt text is a written description of an image that gets read aloud by screen readers for people who can't see. It's the difference between a blind visitor hearing "image457.jpg" versus hearing "Golden retriever puppy playing in autumn leaves." The key is to describe what matters in context—not just what you see visually, but what the image is there to communicate. Check this: When you add an image, first ask yourself what its job is on the page, then write alt text that fulfills that purpose.
Full explanation
Full explanation
Alt text follows a straightforward decision process based on why an image exists. First, determine the image's purpose: is it conveying information, serving a function like a link or button, or just decorative? This context determines what alt text to write. For informative images like photos or illustrations, write a brief description that conveys the essential meaning. For functional images like icons or linked images, describe what happens when you activate it, not what it looks like. Decorative images get empty alt text (alt="") so screen readers skip them entirely.
The process works differently for different image types. A photo of a product on an e-commerce site needs descriptive alt text like "blue ceramic coffee mug with tree motif" because that information matters to buyers. But that same image used as a decorative background on a blog post would get empty alt text since it doesn't add meaningful content. Context is everything—the same image can need completely different alt text depending on how it's used.
Common mistakes include redundant descriptions like "image of a cat" (screen readers already say "image") or dumping information that belongs in the main text. Alt text should be concise—typically a few words, rarely more than a short sentence. It should never duplicate nearby text content. For complex images like charts or graphs, provide a data table or full description elsewhere on the page, then use brief alt text like "Bar chart showing quarterly revenue" and link to the detailed explanation.
Writing good alt text is a skill that improves with practice. Start by asking: if I removed this image, what information would be lost? If the answer is "nothing important," use empty alt text. If important content would be lost, describe it succinctly. When in doubt, user testing with people who use screen readers provides the clearest feedback on whether your alt text actually works.
Research
Research
Alt text is a foundational requirement of web accessibility standards, enshrined in WCAG 2.1 Success Criterion 1.1.1 (Non-text Content). Research shows that poor alt text remains one of the most pervasive accessibility issues on the web today, despite clear guidelines being available for decades. Studies of screen reader behavior reveal that users rely on alt text not just to understand image content, but to navigate efficiently through pages, decide what to engage with, and determine whether they've found what they're looking for.
- W3C Web Accessibility Initiative (2024): Emphasizes that alt text must be "programmatically determinable" so assistive technologies can extract and present it to users in different modalities, including speech, Braille, and large print [2].
- Henry et al. (2014): Found that screen reader users navigate by headings and links first, then examine images when needed, making accurate functional alt text critical for efficient page exploration [3].
Limitations
Limitations
Alt text has inherent constraints that can create accessibility challenges. Extremely complex images like detailed maps, infographics, or works of visual art may require descriptions longer than practical for alt attributes, forcing content creators to decide between oversimplifying or providing separate long-form descriptions. Alt text also struggles with subjective visual elements—humor, emotional impact, aesthetic qualities, and cultural references that depend on visual recognition. Some images serve ambiguous purposes that make the "right" alt text debatable even among accessibility experts. Additionally, alt text cannot convey the experience of seeing an image; it's a functional workaround, not a true equivalent. Emerging AI image description tools show promise but still lack contextual understanding and often produce generic or inaccurate descriptions that require human review.
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] WebAIM: Alternative TextWebAIM (Web Accessibility In Mind) - 2023
- [2] WCAG 2.1 Understanding Guideline 1.1: Text AlternativesW3C Web Accessibility Initiative - 2024
- [3] W3C Images TutorialW3C Web Accessibility Initiative - 2024
- [4] Just Ask: Integrating Accessibility Throughout DesignShawn Lawton Henry - 2014
- [5] Section 508 ICT Accessibility StandardsU.S. Access Board - 2017
Try it
Check your understanding
A travel blog has a photo of a beach sunset with the caption "The most beautiful sunset I've ever seen in Hawaii." What's the most appropriate alt text?
Show the guide's explanation
Answer: "" (empty alt attribute)
The caption already conveys the essential information about the image. Since the image is decorative and its content is presented in the adjacent text, empty alt text (alt="") is appropriate. This prevents screen readers from announcing redundant information while still acknowledging the image exists in the markup.
You're adding an image that serves as a link to a downloadable PDF employee handbook. The image is a document icon. What alt text should you use?
Show the guide's explanation
Answer: "Employee handbook (PDF)"
For functional images used as links, alt text should describe the destination or action, not the image's appearance. "Employee handbook (PDF)" tells screen reader users what they'll get if they activate the link. "PDF document icon" just describes what it looks like, and "Click here to download" is less specific about what they're downloading.
What's the correct first step when writing alt text for an image you're adding to a webpage?
Show the guide's explanation
Answer: Decide whether the image conveys important content or is decorative
The first step is determining the image's purpose and context in the page. This decision determines what kind of alt text to write: informative text for content images, functional description for links/buttons, or empty alt for decorative images. Writing descriptions before understanding purpose leads to either missing important meaning or creating unnecessary verbal clutter.
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.