AccessLens

How to fix: “Images must have alternative text”

Images with no alt text, explained in plain English, with the exact fix and code you can copy.

Scanner rule:
image-alt
Standard:
WCAG 1.1.1 Non-text Content (Level A)

What this error means

An image needs a short text description in its alt attribute so that people who cannot see the image still get its meaning. Screen readers read the alt text aloud. When there is none, many screen readers read out the file name instead, such as 'IMG underscore 2034 dot jpg', or skip the image entirely.

Missing alternative text was found on 53.1% of home pages in the WebAIM Million 2026 report. Source: WebAIM Million

Who it affects

Blind and low-vision visitors using screen readers, people on slow connections where images do not load, and search engines, which also use alt text to understand pictures.

Where it usually hides

  • Product photos and gallery images uploaded without a description
  • Staff headshots, office photos and team pages
  • Image-only buttons and linked banners, where the image is the only content of the link
  • Slider and hero images added by a page builder
  • Logos in the header and footer

How to fix it

  1. Decide what job the image does. If it carries information (a product, a person, a chart), describe it. If it is purely decoration (a divider, a background flourish), give it an empty alt: alt="".
  2. Write the description as if you were reading the page to someone over the phone. 'Golden retriever puppy sitting on grass' is better than 'puppy' and far better than 'image1.jpg'.
  3. Skip words like 'image of' or 'picture of'. Screen readers already announce that it is an image.
  4. If the image is a link, describe where the link goes, not what the picture looks like. A logo that links home should say 'Acme Dental, home'.
  5. If the image contains text, repeat that text in the alt. Better still, use real text on the page instead of text inside a picture.

Before and after

Before

<img src="/images/team-3.jpg">
<img src="/images/hero.jpg" alt="image1.jpg">

No alt, and an alt that is just a file name. Both fail in practice.

After

<img src="/images/team-3.jpg" alt="Dr. Lee smiling beside the reception desk">
<img src="/images/divider.png" alt="">

A real description for a meaningful image, and an empty alt for a decorative one.

On your website platform

WordPress

Open Media, then Library, click the image and fill in the Alternative Text field. In the block editor, select the image block and use the Alternative Text box in the sidebar.

Shopify

For product images, open the product, click an image in the media section and choose the option to add or edit alt text. Images set inside theme sections often have their own alt-text field in the theme editor, or they come from the theme code.

Wix and Squarespace

Click the image, open its settings, and look for the alt text (or 'what's in the image') field. Page builders often leave it blank by default.

Common mistakes

  • Stuffing keywords into alt text. Write for the person listening, not for search engines.
  • Leaving the alt attribute off a decorative image. Without alt="", some screen readers read the file name.
  • Using the same alt text on every image in a gallery.

How to check your fix

  • Re-run a scan to confirm every flagged image is fixed.
  • In Chrome, right-click the page, choose Inspect, and search the HTML for '<img' to see each alt value.
  • Turn on your phone's screen reader (VoiceOver on iPhone, TalkBack on Android) and listen to one page. If an image is announced as a file name, it needs fixing.

Is this on your site?

Run a free scan and see every page and element affected. No account needed.

Questions people ask

How long should alt text be?

Usually a short phrase, around 5 to 15 words. Describe what matters for the page, not every detail. Very long descriptions belong in the page text, with a short alt on the image.

Should decorative images have alt text?

They should have an empty alt (alt=""). That tells screen readers to skip the image, which is the correct behavior for decoration.

Can software write my alt text automatically?

It can give you a first draft, but an automated description often misses why the image is on the page. Review each one, especially for products, people and anything with text in it.

Keep reading

Automated scans catch only part of what WCAG covers, and fixing a scan result is not a legal guarantee of compliance. Last reviewed November 16, 2026.