Alt Text for Functional Images
You'll learn: How to write alt text that describes what an image does, not what it looks like, for clickable icons and buttons.
What Makes an Image "Functional"?
A functional image is one that performs an action when clicked—like a button, link, or icon. Think of a magnifying glass icon that opens search, a trash can icon that deletes an item, or a logo that links to the homepage.
For these images, screen reader users don't need to know the image looks like a magnifying glass. They need to know it will open search when clicked.
Describe the Action, Not the Appearance
When writing alt text for functional images, always describe the destination or action:
❌ Bad (describes appearance):
<a href="/search">
<img src="magnifying-glass.png" alt="Magnifying glass icon">
</a>
✅ Good (describes function):
<a href="/search">
<img src="magnifying-glass.png" alt="Search">
</a>
Common Examples
- Logo linking home:
alt="Home"oralt="Company Name Home" - Shopping cart icon:
alt="View cart"notalt="Shopping cart" - Download button:
alt="Download PDF"notalt="Download icon" - Edit icon:
alt="Edit profile"notalt="Pencil icon" - Social media link:
alt="Follow us on Twitter"notalt="Twitter bird logo"
The Analogy
Imagine asking someone for directions and they say "Turn at the blue rectangle" versus "Turn at the gas station." The second tells you what to do, not just what something looks like.
Key Takeaway: Alt text for functional images must communicate the action or destination, not the visual appearance—tell users what will happen when they interact with it.