Writing good alt text

How to write alt text that helps users and search engines.

Video walkthrough coming soon

What is Alt Text?

Alt text (alternative text) describes an image for people who can't see it — whether they're using a screen reader, have images disabled, or the image fails to load.

The Formula

Describe what's in the image as if you're explaining it to someone over the phone:

<img src="team-photo.jpg" alt="Five team members standing in the lobby, smiling">

Good vs Bad Examples

BadGood
alt="image"alt="Red widget with chrome finish"
alt="photo"alt="Sarah presenting at the 2024 conference"
alt="" (for meaningful images)alt="Chart showing 40% growth in Q3"

When to Leave Alt Empty

Use alt="" (empty, not missing) for decorative images that don't add information:

  • Background patterns
  • Visual separators
  • Icons next to text that already says the same thing