Alternative text supplies the information or function an image contributes in its particular context. It is not an automatic caption, and the same image can require different treatment on different pages.
Finish with
Outcome
A recorded purpose and alt treatment for every reviewed image, including where equivalent text or structured data must appear nearby.
What you need
- The rendered page, the image in context, and access to its HTML or content fields.
- Nearby captions, labels, links, charts, or text that may already provide an equivalent.
- The page task and the information a reader must receive to complete it.
- A worksheet for recording decisions rather than keeping them only in the media library.
The observable problem
Media libraries encourage one reusable description per file, but image purpose changes with context. A photograph may establish who attended an event, illustrate an atmosphere already described, or function as the only link to registration. Those roles cannot share one dependable answer.
Begin with information, not visual inventory. “The page would lose the fact that the accessible entrance is flooded” is an observation about purpose. “Photo of a building, water, gray sky, two doors” may omit the point while sounding detailed. Record nearby equivalent text before deciding what belongs in the alt attribute.
Invented for instruction
Fictional worked example
Fictional worked example: Northbank Neighbours, an invented group, uses the same event photograph in three places. It shows volunteers arranging labeled meal boxes beside the community hall entrance. No real organization or measured event is represented.
On the event recap, the text already says volunteers prepared 120 boxes. The image adds atmosphere but no needed fact, so it receives empty alt. On a facilities update, the photo demonstrates that temporary tables narrow the entrance. The useful alt is “Meal-packing tables narrow the hall entrance to one side.”
On the events index, the photograph is the only content in a link to booking. Its alternative names the function: “Book the community meal.” A weak reusable value such as “Image123” or “Volunteers smiling in a room” would neither communicate the facilities issue nor identify the linked action.
Procedure
Identify the page task and image role
Write what the reader is doing and what changes if the image is hidden. Classify the current role as decorative, informative, functional, text-containing, complex, or redundant. Treat classification as a prompt for reasoning, not a label that writes the final words.
Check nearby equivalents
Read the heading, caption, body text, table, and link label. Note exactly which image information is already available. Do not duplicate a caption without reason. For a chart or map, identify whether the values, trend, route, or decision are available in structured text.
Choose the treatment
Use empty alt for a decorative or fully redundant image while keeping the alt attribute present. For informative images, convey the point needed in context. For an image-only control or link, name its action. For complex information, provide concise alt plus a visible explanation, data table, or equivalent route.
Draft concise context-specific text
Lead with the relevant information or function rather than “image of.” Include text visible inside an image when that text matters and is not repeated nearby. Avoid guessing identity, emotion, disability, gender, ethnicity, or intent from appearance.
Review the rendered result
Inspect the HTML to confirm the intended alt is present, including empty alt where chosen. Navigate linked images by keyboard and listen with available assistive technology when possible. Review translated variants independently because purpose and nearby wording may differ.
Reusable worksheet
| Image and page | Information lost if hidden | Nearby equivalent | Function | Chosen alt treatment | Follow-up |
|---|---|---|---|---|---|
| Meal boxes on facilities update | Tables narrow the entrance | No | Informative evidence | Meal-packing tables narrow the hall entrance to one side | Confirm layout is current |
| Blank placement | State the missing point | Quote or identify it | Decorative, informative, functional, text, complex, redundant | Empty, concise text, action, or nearby equivalent | Name owner or needed test |
Decision rules
- If hiding the image removes no information or function, use an empty alt attribute so it can be skipped.
- If the image is the only content of a link or control, describe the destination or action rather than its appearance.
- If an image communicates complex data, provide concise alt and an adjacent structured equivalent instead of forcing all detail into one attribute.
- If nearby text already gives the same information, avoid needless repetition and record why empty or shorter alt is appropriate.
- If the image’s purpose is uncertain, ask the page owner before inventing a visual description.
Limitations and escalation
- No short decision tree covers every image. Art, diagrams, maps, identity-sensitive photographs, CAPTCHA alternatives, and specialized technical imagery may need subject and user expertise.
- Concise alt cannot replace equivalent access to complex relationships, full chart data, or an interactive map task.
- A correct alt field does not settle image contrast, animation, text legibility, loading behavior, copyright, consent, or representation concerns.
Review list
Check the work
- The image purpose is recorded for this exact page placement.
- The decision begins with information or function, not a generic visual inventory.
- Decorative images retain an empty alt attribute.
- Functional images name the action or destination.
- Complex information has a visible, structured equivalent.
- The rendered HTML and keyboard behavior were checked after publication.
Review again when
- The image moves to a new context
- Nearby copy or captions change
- An image becomes a link or control
- A chart’s data changes
- Translation changes the available equivalent