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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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-purpose worksheet. Decisions apply to this placement, not automatically to every reuse of the file.
Image and pageInformation lost if hiddenNearby equivalentFunctionChosen alt treatmentFollow-up
Meal boxes on facilities updateTables narrow the entranceNoInformative evidenceMeal-packing tables narrow the hall entrance to one sideConfirm layout is current
Blank placementState the missing pointQuote or identify itDecorative, informative, functional, text, complex, redundantEmpty, concise text, action, or nearby equivalentName 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