Recent chats
ASKGEEZ Q&A GUIDEWriting & communication

How do I describe an image when its purpose changes between pages?

Quick answer

Write an image description for the job the image does on that particular page, not just for the image itself. First note the page’s purpose, then identify what information or function the image contributes there. The same image may need different descriptions in different contexts—or may be decorative in one. Check that each version supports its page without adding details the image or context does not establish. [S1]

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

How should I start if the same image appears in two places but I’m not sure whether its description should change?

Geez

Separate what is visibly in the image from what the image does on each page. A description is not simply a list of visible objects: its useful content depends on the meaning or function the image has in that location. W3C illustrates this with a dog image that conveys breed information on one page but is decorative on another. [S1]

For each location, complete this sentence: “On this page, the image helps the reader ___.” Then consider whether the image supplies information the surrounding text does not already provide, or serves a decorative role. Make the decision separately for each placement, even if the file is identical.

Copy this worksheet:

  • Image: [brief, observable description]
  • Page A purpose: [what readers are doing or learning]
  • Image’s role on Page A: [information, function, or decoration]
  • Description for Page A: [the information or function that matters here]
  • Page B purpose: [what differs from Page A]
  • Image’s role on Page B: [information, function, or decoration]
  • Description for Page B: [the information or function that matters here]

If you don’t know what the image depicts or why it is on the page, mark that as something to confirm instead of filling in the gap.

Follow-up question

Can you show what that looks like with contrasting examples?

Geez

Yes. These are hypothetical assumptions to demonstrate the method, not claims about a real image. Assume the image shows a dog, and someone has confirmed that it depicts a beagle.

  1. Page A: a guide comparing dog breeds. The page helps readers distinguish breeds. If the image identifies the breed, a possible description is “Beagle.” In this assumed context, the useful point is the breed information, not every visible detail.
  2. Page B: a general event page, with the same dog image used as decoration. If the image contributes no information or function to that page, a description may not need to convey the dog’s breed. W3C’s example supports judging the image by its context; it does not prescribe exact wording for these hypothetical pages. [S1]

If instead the dog image links to a page about adopting that specific dog, its role changes: the description should communicate the link’s purpose, using only details you have confirmed. Don’t invent the animal’s name, traits, or destination.

Follow-up question

What if the page already explains the same information, or I don’t know the image’s purpose?

Geez

Compare the image with the nearby text and the page’s purpose. If the image communicates a particular fact, ask whether that fact is already clear in the surrounding content. Avoid adding unrelated visual details just to make the description longer. If the image’s role is unclear, ask the page owner or author what it is meant to contribute.

You could write: “This image appears to show [observable detail]. On this page, I think it may support [purpose], but please confirm whether it is [informative / functional / decorative].” This makes uncertainty actionable without presenting your interpretation as fact.

The key is to judge the image in context and convey the meaning or function needed on that page. There is no universal sentence formula that determines the role of a particular image for you. [S1]

Follow-up question

How can I check both descriptions before they go live?

Geez

Review each placement independently. Read the page purpose, image, and surrounding text together. Ask: does this description communicate the image’s relevant information or function here, and have I avoided details that are guesses? Then compare the versions. They can differ when the image does different work; they do not need to differ just because they appear on different pages.

For the hypothetical beagle examples, the breed-comparison page may need “Beagle,” while the decorative use on the general event page may not need a description conveying breed information. Those choices depend on the assumed page roles, not on a universal rule about dog images. [S1]

If a reviewer can’t tell why the image is present, pause and confirm its purpose rather than polishing a description for an unconfirmed role.

A practical checklist

  • Write down the purpose of each page where the image appears.

  • Describe only observable image details; mark unconfirmed details for checking.

  • For each placement, decide whether the image conveys information, performs a function, or is decorative.

  • Draft a description for each distinct role without adding unsupported details.

  • Read each draft alongside the page text and confirm the intended purpose when it is unclear.

A few more useful answers

Does the same image always need different descriptions on different pages?

No. Base each description on the image’s role in that location. If its role and relevant meaning are the same, the wording may also be the same.

Should I describe everything visible in the image?

Not automatically. Focus on the information or function the image contributes on that page, and avoid details that do not help convey that role.

What should I do if I can’t tell whether an image is decorative?

Record what you can observe and ask the page owner or author to confirm its intended role. Don’t guess at the purpose.

Sources

References used for this guide.

  1. [S1] Easy Checks – A First Review of Web Accessibility
    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