How do I decide whether an image needs alt text or can be treated as decorative?
Quick answer
Ask what the page would lose if the image were removed. If it conveys information needed to understand the page, write a concise alternative that communicates that information. If it acts as a control or link, describe its function. If it adds no important information and serves only as decoration, an empty alternative may be appropriate. Decide from the image’s actual context, not a guess about its meaning. [S1]
The question, the details, the next step.
A practical checklist
Review the image alongside its heading, caption, nearby text, and any link or control.
Decide whether it conveys essential information, performs a function, is purely decorative, or has an unclear role.
For informative images, include only essential details supported by the page context.
For functional images, describe what the link or control does, not merely what it looks like.
Use an empty alternative only when the image is decorative and conveys no information important to understanding the page.
Ask the responsible person to clarify the intended role instead of guessing.
A few more useful answers
Should I describe every visible detail in informative alt text?
No. Focus on the information essential to understanding the image in that page context. Avoid adding details that are not supported by the context. [S1]
Can an image be decorative even if it is visually detailed?
Yes. The decision is about whether it conveys information important to understanding the page, not how detailed it looks. [S1]
What should I do when the image’s purpose is unclear?
Check the surrounding page content and ask the responsible person to confirm its role. Don’t make up an interpretation based only on appearance.
Sources
References used for this guide.
- [S1] Images Tutorial: Choosing Text Alternatives by Image Purpose w3.org · Checked
