Alt text checker
Find missing alt attributes and image descriptions that need a context review. Your HTML stays in your browser.
Alt text review
3 of 4 images flagged
Missing alt attributes
1
Images found
4
Every image needs a context check, including images without warnings.
4 images found. 1 missing alt attribute. 3 images flagged for review. Every image still needs a context check.
Image-by-image report
| Image | Supplied alt text | Review |
|---|---|---|
| Image 1, line 1, column 1: /images/blue-boots.jpg | "Blue ankle boots with a side zip" | Alt text is present. Compare it with the image and surrounding content. |
| Image 2, line 2, column 1: /images/sole.jpg | (missing attribute) | Missing alt attribute. Add an alternative that fits the image’s purpose, or use empty alt for confirmed decoration. |
| Image 3, line 3, column 1: /images/flourish.svg | "" | Review empty alt. Confirm the image is decorative or its meaning is already in nearby text. |
| Image 4, line 4, column 19: /images/boots.jpg | "boots.jpg" | Alt text matches the filename. Replace it if it does not convey the image’s meaning or action. Image in a link or button without other text. Check that its accessible name conveys the destination or action. |
Showing all 4 images.
Missing alt and deliberately empty alt
A missing alt attribute and an empty alt value mean different things. The checker reports them separately so you can choose the right treatment for each image.
Missing means the image tag has no alt attribute. Empty means the attribute is present with no text, as in alt="". Whitespace-only text gets its own warning.
W3C’s image decision tree uses empty alt for decoration and for images whose meaning is already available in nearby text. An empty value needs a purpose check before you replace it.
In the fictional example, four images produce three review flags. One has no alt attribute, one has an empty value and the linked image repeats its filename. The described boots image still needs a person to compare its wording with the image.
The starting HTML is a fictional four-image example.
Review product images in context
The same photograph can need different alt text on different pages. A person must decide what the image adds where it appears.
Imagine a blue boot photograph used as decoration behind a heading that already names the product. Empty alt can suit that use. On a product page, the same photograph might show the boot’s side zip. A description such as “Blue ankle boot with a side zip” conveys that detail.
When an image is the only content of a link, its alternative needs to explain the destination or action. W3C’s functional image examples show how surrounding link text changes that choice.
Before keeping an empty value, check the image’s purpose.
- Compare the product details shown with the surrounding description.
- Check whether a link or button depends on the image for its meaning.
- Look for useful words in the image that are absent from the page text.
- Confirm that the image is decorative or repeats meaning already available nearby.
Act on the report
Start with missing attributes, then review the warnings against the real page. A repeated description can be correct when several images convey the same meaning.
The checker reads img tags from the HTML you paste. It decodes escaped attribute text and reports missing, empty and whitespace-only values. Repeated descriptions ignore letter case and extra spaces. Filename warnings compare the alt text with the source filename, its name without an extension and its words separated by spaces.
Link and button warnings identify images without other text in that control. The report retains a supplied aria-label and image role in the download. This is a context prompt, not a calculation of the control’s accessible name.
The checker parses text without displaying the supplied HTML or loading its images. It skips images inside comments, scripts and inert templates. It does not inspect CSS background images, SVG alternatives or images added later by page scripts.
The report cannot see image content, external styles or the complete page’s accessibility tree. A description with no warning can still be wrong. Compare it with the displayed image and use the guide to writing product image alt text when you rewrite it.
Download the report to keep each image’s line and column in the pasted HTML. Correct your original markup, then paste it again to check the attributes.
The text report includes every image, its source location and supplied attributes.