An attractive image can still create a barrier if its purpose is unavailable to someone using a screen reader, zoomed display or high-contrast setting. Accessibility starts before upload: choose an image that communicates clearly, then provide an appropriate text alternative in the page or app where it appears.
Alt text is not a place to repeat keywords. It should communicate the image's purpose in that specific context. The same photo may need different alt text on a news story, a product page and a decorative banner.
Describe purpose, not every pixel
Ask what a sighted reader learns from the image that is not already present in nearby text. A product photo may need the colour and distinguishing feature. A chart needs its important trend or conclusion. A decorative flourish may need an empty alt attribute so assistive technology can skip it.
Avoid openings such as “image of” unless the fact that it is a photograph, illustration or screenshot matters. Screen readers already announce the element as an image in many contexts.
Examples of context-aware alternatives
| Image use | Weak alternative | More useful direction |
|---|---|---|
| Product listing | shoe | Include style, colour and visible identifying detail |
| Instructional screenshot | settings page | State the control and action the screenshot demonstrates |
| Data chart | sales graph | Summarise the central comparison or trend in nearby text |
| Decorative pattern | green pattern | Use empty alt text when it adds no information |
Do not make the image the only source of text
Posters and social graphics often contain essential dates, prices or instructions inside pixels. Repeat that information as real text near the image so it can reflow, be translated, be selected and be read by assistive technology. Alt text alone is not ideal for a long block of copy.
Use sufficient contrast and leave room around lettering. Test the graphic at the small size used on a phone; text that is readable in an editor at full zoom may be illegible in a feed card.
Pre-publish review
- Identify whether the image is informative, functional or decorative.
- Write the alternative for the image's purpose on this page.
- Repeat essential words, numbers and instructions as normal page text.
- Check contrast and legibility at mobile size and at 200% zoom.
- Keep file size reasonable so slow connections do not become an access barrier.
Review note
This guide explains practical image decisions and the limitations of common browser workflows. Requirements from a government form, marketplace, printer or publishing platform should take priority when they specify exact dimensions or formats.
Frequently asked questions
How long should alt text be?
Use the shortest wording that communicates the image's purpose. Put complex explanations, such as chart analysis, in nearby page text.
Should a logo have alt text?
A linked brand logo normally needs the organisation or destination name. A repeated decorative mark may not need to be announced again.
Can AI-generated alt text be published without review?
It should be checked by a person who understands the page context because object recognition alone may miss the image's real purpose.