How do I get meaningful descriptions of images while browsing?
Quick answer
Image alternative text, often called alt text, is a text replacement that assistive technology can read; it may also appear if an image fails to load. Meaningful alt text conveys an image’s content in the context of the page, while decorative images may appropriately have empty alt text. If a description is missing or unclear, check nearby text for clues. If the meaning remains unknown, report the image and explain what information you need rather than guessing.
The question, the details, the next step.
What does an image description mean, and where should I look for it?
On a web page, an image description is often called alternative text, or alt text. It is a textual replacement that assistive technology can read, and it may be shown if the image fails to load. For a meaningful image, useful alt text conveys its content in the context of the page; a decorative image may appropriately have empty alt text. [S1]
Not every visible image needs a spoken description. A decorative flourish may add no information, while a chart or instructional diagram may carry meaning. The description should help convey what the page is communicating, not merely list objects in the picture.
If you can see the page, look for a caption, nearby paragraph, or heading that refers to the image. Those may offer clues, but they are not guaranteed to explain it fully.
I found an image with no useful description. What can I try before reporting it?
First, identify what you need to learn from the image. Then check the page for that information in another form:
- Read the nearby heading, caption, and paragraphs.
- Look for a legend, label, or linked description that explains the relevant content.
- If the image supports a task, check for written instructions or equivalent details elsewhere on the page.
- If the page still does not answer your question, treat the image content as unknown rather than guessing.
For example, a chart titled “Monthly sign-ups” tells you its subject, but not its values or trend. Look for a written summary or data table on the page. If neither is present, do not claim sign-ups rose or fell unless the page provides that information. The reference explains the role of alt text; it does not establish that a browser can reliably reconstruct missing image content. [S1]
How do I report the problem so the site can understand what is missing?
Use the website’s feedback or accessibility contact route if one is available. Identify the page by its title or a link you can copy, and locate the image by its nearby heading, caption, or position. Avoid including personal or sensitive information that is not needed to explain the barrier.
Say what you were trying to learn or do, what description you encountered (for example, “no description announced” or “the text did not explain the chart”), and what information would help. Do not invent a description of an image you could not interpret. You are reporting the gap, not expected to write an accurate description yourself.
Copyable report: “On [page title or page link], the image near [heading or caption] does not give me enough information to [task or question]. Please provide a text description or equivalent information covering [specific information needed].”
Replace the brackets with details you know. This identifies the barrier without claiming facts about unseen content.
What details should I keep in my report, and what should I leave out?
Keep the report focused on one image or a related group. Include the page identifier, a way to find the image, the task or question you could not complete, and the information that would resolve the barrier. If a description is present but unhelpful, say what it fails to explain rather than simply calling it “bad.”
For example: “The image near ‘Choose a plan’ does not distinguish the two options, so I cannot tell which plan includes [feature]. Please provide that information in text.” Replace the bracket only with a detail you actually know. If you do not know what the image shows, say so; do not guess.
You do not need to propose exact alt text. The page author should provide a description suited to the image’s purpose and context. [S1]
A practical checklist
Identify the page and image using a nearby heading, caption, or position.
Check surrounding text and linked explanations for the information you need.
Separate what the page states from what you are guessing about the image.
Explain the task or question blocked by the missing or unhelpful description.
Ask for the specific information in text; do not invent details.
A few more useful answers
Does every image need a spoken description?
Not necessarily. Decorative images may appropriately have empty alternative text, while meaningful images should have text that conveys their content in context. [S1]
Can I rely on a browser to describe an image when the page has no useful text?
Do not rely on a browser to reliably reconstruct unseen image content. The cited reference explains page-provided alternative text, not a browser feature that supplies missing information. [S1]
Do I have to write the replacement description in my report?
No. Explain which image is unclear, what you need to understand, and what information is missing. Avoid guessing at details you cannot verify.
Sources
References used for this guide.
- [S1] The <img> element: alternative text and accessibility developer.mozilla.org · Checked