Recent chats
ASKGEEZ Q&A GUIDEWriting & communication

How do I make a visual instruction usable for someone who cannot see the image?

Quick answer

Write the text alternative to convey the image’s purpose in that spot: if it teaches an action, state the instruction, not just what the picture looks like. If it performs a function, name the function. When the visual contains several steps or details, explain them in nearby text; when it adds nothing important, leave it out of the text alternative. Check that someone can follow the instruction without seeing the image. [S1] [S2]

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

I’m writing instructions for a reusable water bottle. There’s a small drawing showing how to fit the drinking spout into the lid. How do I write a text alternative that helps someone do it, rather than just describing the drawing?

Geez

Start with the image’s job in this particular instruction. If the drawing teaches an action, make the text alternative state that action. W3C guidance says an informative image’s alternative should convey its meaning, not necessarily describe it literally; for an instructional diagram, a short alternative can give the instruction. [S1] [S2]

For example, assuming the drawing shows a spout being pushed into the lid, a useful draft might be: “Push the spout into the lid until it sits in place.” That example is a placeholder: confirm the wording against the actual product and approved instructions. Avoid a purely visual caption such as “A close-up drawing of a spout and lid” if it does not tell the reader what to do.

Follow-up question

What if the drawing shows several parts or arrows? I don’t want the short text alternative to turn into a whole paragraph, but I also don’t want to leave out a necessary step.

Geez

Use the short alternative for the visual’s main instructional point, then put the full sequence in the surrounding instructions if the image contains more information than a short phrase can carry. W3C recommends providing complex image information elsewhere in text, and says more extensive instructional-diagram information can go in the main text or another suitable text equivalent. [S1] [S2]

For a hypothetical diagram with three actions, the nearby text could say:

  1. Place the spout above the lid opening.
  2. Align the spout with the opening.
  3. Press it into place, following the product’s verified instructions.

A concise alternative could then be: “Align and fit the spout into the lid; steps follow.” Treat this as a writing pattern, not product-specific directions. Check that the nearby steps really do explain the information the diagram contributes.

Follow-up question

How do I decide whether a picture needs any text alternative at all? Some pages have a decorative picture next to the instructions, while others have an icon you click to open a guide.

Geez

Ask what the image does in that context. If it adds no important information, W3C guidance says a decorative image should have an empty alternative. If it is functional, convey its function rather than merely describing its appearance. [S1]

So, if a picture is only decoration beside complete written instructions, it may not need extra descriptive wording. If an icon opens a guide, wording such as “Open the assembly guide” communicates its purpose more clearly than “book-shaped icon.” These are editorial examples; confirm that the label matches what the control actually does. The same image might be informative in one context and decorative in another, so judge its role on the page rather than by its appearance alone. [S2]

Follow-up question

Can you give me a quick worksheet I can use while drafting a page with an instructional image?

Geez

Fill in this worksheet for each image, then read the page as if you could not see it:

Visual-reference text worksheet

  • Where does the image appear? [section or instruction]
  • What does it help the reader understand or do? [purpose]
  • Is it informative, functional, decorative, or complex here? [role]
  • Short text alternative, if needed: [main instruction or function]
  • Information that needs to appear in nearby text: [steps, labels, relationships, or other essential details]
  • Check: Can the reader understand the instruction without relying on the image?

For a hypothetical spout diagram, you might write: “Purpose: show how the spout fits the lid. Short alternative: ‘Fit the spout into the lid opening.’ Nearby text: list any verified alignment or fitting steps shown. Check: the written instructions explain every necessary action.”

This worksheet helps organize the writing; it is not a technical accessibility certification. The cited guidance covers web images and text alternatives, and does not establish whether a particular page or product meets accessibility requirements. [S1] [S2]

A practical checklist

  • Name the image’s purpose in the specific place it appears.

  • For an instructional image, draft the action or meaning before describing its appearance.

  • For an image that performs a function, state the function the reader needs.

  • Move extensive visual details or step sequences into nearby text.

  • Leave out extra wording for an image that adds no important information.

  • Check that the written instructions make sense without seeing the image.

A few more useful answers

Should I describe every object, arrow, and color in an instructional image?

Not automatically. Include details that communicate the instruction; put extensive information into nearby text rather than making a short alternative carry the whole explanation. [S1] [S2]

Can the same image need different text in different places?

Yes. Decide whether it is informative, functional, or decorative based on why it appears in that context. [S2]

Does this worksheet certify that my page is accessible?

No. It is a writing aid. The cited guidance explains how to plan image text alternatives but does not certify a page or assess a particular implementation. [S1]

Sources

References used for this guide.

  1. [S1] Images Tutorial | Web Accessibility Initiative (WAI) | W3C
    w3.org · Checked
  2. [S2] Informative Images | Web Accessibility Initiative (WAI) | W3C
    w3.org · Checked

YOUR QUESTION. YOUR DETAILS.

Let’s work through your situation.

Get a tailored answer or help with your next task. Starts at $1, with a quote before you pay.

Ask your own question
← Back to Geez at Work