Recent chats
ASKGEEZ Q&A GUIDEWriting & communication

How do I decide whether an image needs alt text or can be treated as decorative?

Quick answer

Ask what the page would lose if the image were removed. If it conveys information needed to understand the page, write a concise alternative that communicates that information. If it acts as a control or link, describe its function. If it adds no important information and serves only as decoration, an empty alternative may be appropriate. Decide from the image’s actual context, not a guess about its meaning. [S1]

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

I’m checking images in a page draft. What’s the quickest way to decide whether an image needs alt text or can be decorative?

Geez

Start with the image’s job on that page, not with how interesting or detailed it looks. Ask: “If this image were absent, would someone lose information needed to understand the page or use it?” The text alternative depends on the image’s usage, context, and content. Informative images need alternatives conveying their essential information; images that only decorate and add no important information can have an empty alternative; functional images need an alternative describing their function. [S1]

A practical first pass is:

  1. It communicates relevant information: write informative alt text.
  2. It performs an action or serves as a link: describe its function or purpose.
  3. It adds no information and is purely decorative: an empty alternative may be appropriate.

Don’t decide from the picture alone. The same image might be informative in one place and decorative in another.

Follow-up question

Can you show how the same image might get a different decision depending on context?

Geez

Suppose a page uses a photo of a red umbrella. These are hypothetical examples, not claims about any particular image:

  • In an article explaining how to identify the umbrella mentioned in a lost-property notice, the color and object may matter. A possible alternative is: “Red umbrella left near the entrance.” Use it only if those details match the supplied context.
  • If the photo is a link that opens an umbrella product page, describe the link’s purpose, such as “View red umbrella details,” if that is what the link does.
  • If it sits behind a heading as decoration and conveys no information needed to understand the page, an empty alternative may be appropriate.

The key is not to narrate every visible detail. Select what helps someone understand the image’s role in that specific page. If nearby text already explains the relevant information, check whether the image adds anything meaningful before writing a second description.

Follow-up question

What if I can see the image but don’t know what it’s supposed to mean?

Geez

Don’t invent a purpose or infer details the page context does not establish. Check the nearby heading, caption, link text, and surrounding copy, then ask the person responsible for the page what the image is meant to communicate or do. Context is part of the decision, so guessing from appearance alone can lead to an alternative that misses the image’s role. [S1]

Until the context is clear, record a question rather than approving guessed wording. For example: “Please confirm whether this image illustrates the process, links to another page, or is only decorative.” If it is a chart, diagram, or image containing text, ask what information readers are expected to take from it. The guidance supports choosing alternatives by purpose and essential information, but it does not establish the intended meaning of a particular picture. [S1]

Follow-up question

Can I use a small review template so I make the decision consistently?

Geez

Yes. Fill in the context before drafting an alternative:

“Page or section: [where the image appears] Image’s role here: [information / action or link / decoration / unclear] What readers need from it: [essential information or function, if any] Decision: [informative alt text / function-focused alt text / empty alternative / ask for context] Draft or question: [proposed wording or clarification request]”

Worked hypothetical example:

“Page or section: [event registration page] Image’s role here: [unclear] What readers need from it: [not confirmed] Decision: [ask for context] Draft or question: [Does this image communicate event details, link to registration, or serve only as decoration?]”

Once its role is confirmed, write a short description that covers the relevant information or function—or choose an empty alternative if it is only decorative. Read it alongside the page: it should convey the image’s needed meaning or purpose without introducing unsupported details. The final decision depends on the actual page context. [S1]

A practical checklist

  • Review the image alongside its heading, caption, nearby text, and any link or control.

  • Decide whether it conveys essential information, performs a function, is purely decorative, or has an unclear role.

  • For informative images, include only essential details supported by the page context.

  • For functional images, describe what the link or control does, not merely what it looks like.

  • Use an empty alternative only when the image is decorative and conveys no information important to understanding the page.

  • Ask the responsible person to clarify the intended role instead of guessing.

A few more useful answers

Should I describe every visible detail in informative alt text?

No. Focus on the information essential to understanding the image in that page context. Avoid adding details that are not supported by the context. [S1]

Can an image be decorative even if it is visually detailed?

Yes. The decision is about whether it conveys information important to understanding the page, not how detailed it looks. [S1]

What should I do when the image’s purpose is unclear?

Check the surrounding page content and ask the responsible person to confirm its role. Don’t make up an interpretation based only on appearance.

Sources

References used for this guide.

  1. [S1] Images Tutorial: Choosing Text Alternatives by Image Purpose
    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