Course contentsShow
← Web Development
Lesson 1138 of 2,98220. Screen Readers and Assistive TechnologyFree lesson

Writing Descriptive Alt Text

Crafting clear, concise descriptions that convey the image's content and purpose in context.

Writing Descriptive Alt Text

You'll learn how to craft alt text that clearly conveys both what an image shows and why it matters in its specific context.

Understanding Descriptive Alt Text

You've learned when alt text is required—now let's focus on writing it well. Good alt text isn't just about describing what you see; it's about communicating the purpose and content of an image in a way that makes sense for users who can't see it.

Think of alt text like describing a photo over the phone to a friend. You wouldn't just say "a person" or dump every tiny detail. You'd give them the relevant information that helps them understand what's happening and why it matters.

Core Principles

Be clear and concise: Aim for one sentence when possible. Screen readers already announce "image," so skip redundant phrases like "image of" or "picture of."

<!-- ❌ Too vague -->
<img src="team.jpg" alt="people">

<!-- ❌ Too wordy -->
<img src="team.jpg" alt="Image of five people standing in an office with laptops">

<!-- ✅ Just right -->
<img src="team.jpg" alt="Development team reviewing code at standup meeting">

Match the context: The same image needs different alt text depending on its purpose.

<!-- On a product page -->
<img src="shoe.jpg" alt="Blue running shoe with mesh upper and white sole">

<!-- In a blog about the designer -->
<img src="shoe.jpg" alt="Designer Maria Chen's award-winning shoe design">

Convey meaning, not just appearance: Focus on what information the image communicates, not just visual details.

<!-- ❌ Describes appearance only -->
<img src="chart.jpg" alt="Bar chart with blue and red bars">

<!-- ✅ Conveys the information -->
<img src="chart.jpg" alt="Sales increased 40% in Q3 compared to Q2">

Key Takeaway: Effective alt text is concise, contextually appropriate, and focuses on the image's informational purpose rather than just its visual appearance.