Choose text for the role of the image

Describe the information that matters in this context. An attribution caption and alternative text serve different purposes.

Four images, four decisions
SituationWhat mattersPractical decision
Informative photoInformation missing from adjacent textDescribe the detail that helps explain the subject.
Linked imageThe destination or actionName the destination rather than merely describing the shape.
ChartThe conclusion and valuesProvide a short description and a nearby table or detailed explanation.
Pure decorationNo additional informationOn a web page, use alt="". For a social network, check its available options.

Example: “Three volunteers install a ramp at the entrance” conveys more than “Nice photo”. Do not infer an identity, disability or emotion that the image cannot establish.

W3C WAI: image decision tree ·

A person examining a photograph before describing it — AI-generated photograph
AI-generated photograph · Fictional scene. Credits

Start with the purpose

An image may show an entrance, explain a gesture or present a result. The same photo needs different descriptions in an announcement and a portfolio. Write the information needed to understand or act first, then details relevant to the subject.

Adapt the description

W3C distinguishes informative, decorative, functional and complex images. For a chart, make values and explanations available as text too. For a poster, put times and location in the post itself, not only in the image’s pixels.

Review without guessing

Do not invent identity, emotion or circumstances from appearance. An automatic description is a draft: check names, numbers and relevant details. Avoid repeating the entire caption when it already gives context; add complementary visual information.

Check each post

Find the description feature in the app’s current help. Otherwise, include a readable description in the text accompanying the image. Each carousel image may convey different information. Review the message without images to find instructions that no longer make sense.

Choose the right check for the situation

These editorial pointers help prepare and review your work. Choose the situation matching your content; check current features and conditions in the cited sources before applying it to a service.

Situations, useful actions and mistakes to avoid
SituationUseful actionMistake to avoid
Entrance photographDescribe the door and route needed to arrive; keep the address in the text.Inferring venue accessibility from the photograph alone.
Results chartProvide the trend, period, units and access to values as text.Describing only the colours of lines.
Tutorial carouselName the step and decisive action for each image; check their order.Copying the same alternative text onto every image.
Purely decorative photographCheck whether removing the image changes meaning. On your site, follow W3C guidance for decorative images.Adding a long description that interrupts reading without information.

Hypothetical example: apply the method

An association announces a workshop in a building with two entrances. The description says “Entrance through the blue door on the right of the courtyard.” The title and time remain in the announcement text.

Template to adapt

Copy this outline into your working document. It collects no information on this site; complete it for your situation.

Image purpose:
Essential visual information:
Text already present:
Additional description:
Names and numbers checked:

Your pre-use check

Checks for this method

0 / 4 checks completed

Frequently asked questions

Should every detail be described?

Select those relevant to the message. A list of colours and objects can obscure the essential information.

Is alternative text enough?

It addresses a specific need. Structure, contrast, captions and comprehension require other checks.

Continue with related content

Make posts accessible and understandable

Sources and scope

Primary references consulted for factual points. Methods and templates are editorial suggestions; service conditions should still be checked in current documentation.

A question before putting this into practice

Should alternative text repeat the entire caption?

Keep what is needed to understand the image’s role without unnecessarily repeating nearby text. For a complex chart, provide a short description and make data or detailed explanation available in the content. Read the complete page as though the image were unavailable.

Before publishing: prepare the message and its audience

Define recipients, check rights, prepare an accessible equivalent and plan corrections. A checklist accompanies your plan.

Plan my publication →

Continue the process

A logo used as a link

  • Logo alone in a link: “Association home” identifies the destination.
  • Logo beside “Association home” within the same link: an empty alternative avoids repetition.
  • Icon alone on a button: describe the action, for example “Search”, rather than its shape.

W3C examples