How to fix “Images must have alternative text”
By Justin Zagar · Updated
An image on the page has no alt attribute, so a screen reader has nothing to say in its place. Give every image an alt attribute: a short description when the picture carries meaning, or alt="" when it's only decoration.
- axe rule
image-alt(this page also coversrole-img-alt)- WCAG
- 1.1.1 Non-text Content (Level A)
- Lighthouse
- Google Lighthouse and PageSpeed Insights report it as “Image elements do not have [alt] attributes”
What it means
Alt text is the words a screen reader reads out instead of a picture. Without an alt attribute at all, many screen readers fall back to reading the file name, so a visitor hears something like "IMG underscore 4471 dot jpeg".
The WebAIM Million found missing alt text on 53.1% of home pages in 2026, and 16.2% of all the images it checked had none. It's the second most common failure after contrast.
The rule asks only that the attribute is there. It can't tell whether the words are any good, so a person still has to read them.
Who it affects
People who are blind and use a screen reader, people on slow connections where images don't load, and search engines, which read alt text too.
How to find it
- Run the free checker. Each image without alt is listed with its code, so you can match it to the picture.
- Check product photos, logos, staff photos and any image that's also a link. Those matter most.
How to fix it
- Ask what the image is there to do. If it shows something the text doesn't say, describe that in a short phrase.
- If the image is a link, the alt text should say where the link goes, not what the picture looks like.
- If the image is decoration, or the same thing is already said in text right beside it, use alt="". That tells a screen reader to skip it.
- Leave out "image of" and "picture of". The screen reader already says it's an image.
- Set the alt text in the media library where you can, so every place the image is used gets it.
A product photo
<img src="ac-2213.jpg"><img src="ac-2213.jpg" alt="Silver 18 inch five spoke alloy wheel, front view">A decorative divider
<img src="swirl.png"><img src="swirl.png" alt="">An empty alt is a deliberate choice, not a missing one. The checker accepts it.
A logo that links home
<a href="/"><img src="logo.svg"></a><a href="/"><img src="logo.svg" alt="Sample Plumbing, home"></a>In your website builder
Where each platform’s own help pages cover it, as of November 2026. Menus move, so follow the link if a step doesn’t match what you see.
- WordPress
- Select the Image block, then Settings sidebar > Alternative text, or tick Mark as decorative. To set it once for every use, go to Media > Library, open the image and fill in Alt Text. WordPress help
- Squarespace
- Edit the page, click the image block, click the pencil icon, and on the Content tab fill in Image alt text. Squarespace help
- Wix
- Click the image, open Settings, and fill in the field "What's in the image? Tell Google." Wix help
- Shopify
- For product photos: open the product, click the image, then Add alt text and Save alt text. Theme images are set in Online Store > Edit theme, on the image's own settings. Shopify help
- Webflow
- In the Assets panel, click the cog on an image and fill in Descriptive, or mark it Decorative. To change one use of the image, select it and pick Custom description under Alt text. Webflow help
Questions people ask
How long should alt text be?
Usually a short phrase or one sentence. Shopify's own guidance suggests about 125 characters. If a chart or diagram needs more, put the full explanation in the page text and keep the alt short.
Does alt text help SEO?
Search engines read it, so a good description helps them understand the picture. Write it for the person listening first. Stuffing keywords into alt text makes it worse for them.
What a scanner can and can’t tell you
Fixing this clears one automated check. It doesn’t mean the page is accessible, and it doesn’t settle any legal question. Automated tests catch only part of the problems. W3C puts it plainly: evaluation tools “can not determine accessibility, they can only assist in doing so.” The rest takes a person working through the site with a keyboard and a screen reader.
Source: W3C WAI, Selecting Web Accessibility Evaluation Tools. Not legal advice.
Sources
All checked November 8, 2026. The rule wording is axe-core 4.14.0’s own.
Related fixes
- Image buttons must have alternative text
Image buttons without alt text
- <svg> elements with an img or image role must have alternative text
SVG images without alt text
- Links must have discernible text
Links with no text
Check a page for free
Scan any page of your site against WCAG 2.1 AA in about 30 seconds. You get the problems automated testing finds, in plain words, with a link to a fix guide for the common ones.
Rather have someone fix it for you? Tell me about your site.