Merchlint
Available now
Next, in this order
  • DeutschDE
  • EspañolES
  • FrançaisFR
  • ItalianoIT
  • PortuguêsPT
  • NederlandsNL
  • SvenskaSV
  • TürkçeTR

A language shows up here once its pages are actually written. Nothing on this site is machine-translated, except a few German and Spanish pages that no native speaker has reviewed yet.

Install free Install
← All checks

Product images with no alt text

The Media Library field is empty or holds only a filename. WooCommerce 9.5+ shows the product name instead; older versions and some themes show nothing.

Group
Content
Confidence
F — fact read directly from your store
Name on the plugin screen
Image with no alt text
Included in
the free plugin
Updated
Code
C2

The symptom

Nothing on the page looks wrong, because alternative text is invisible when everything works. You find out about it in one of three ways: an accessibility audit, a customer who uses a screen reader, or a look at how little traffic your product photos bring in from image search.

In the Media Library the Alternative Text field is simply empty. On a catalog built by import, it is empty for every image at once. Some import tools fill it with the filename instead (IMG_4471.jpg), which tells a visitor just as little.

What the visitor gets in its place depends on WooCommerce and the theme. WooCommerce 9.5 and later put the product name there on the product page (“Wool throw - Image 2”); older versions and many themes render nothing; some gallery plugins put the filename there.

What it costs

Alternative text does three separate jobs, and an empty field fails all three.

  • Image search cannot read a photograph. It reads the alt text, the filename and the surrounding page. For visual categories—furniture, clothing, tools, parts—image search is a real share of discovery traffic, and IMG_4471.jpg with no alt tells it nothing. The product name that WooCommerce fills in is better than nothing, but it says what the product is called, not what the photo shows.
  • A screen reader gets nothing—or the filename. With an empty alt="" it skips the photo; where a gallery plugin puts the filename there, someone shopping without sight hears “I-M-G underscore 4-4-7-1 dot jay-peg” where the product photo should be. In the EU, the European Accessibility Act has applied to e-commerce services since June 28, 2025. That is a fact about the law, not a verdict about your store. What it requires of you is a question for your lawyer, not for an audit tool.
  • When the image does not load, the space is blank. Slow connection, blocked CDN, moved file: alt text is what the browser puts there instead. Without it, the page silently loses the product.

How to check it yourself

Alt text lives in postmeta on the attachment, not on the product:

wp db query "SELECT a.ID, a.post_title, a.guid
  FROM wp_posts a
  LEFT JOIN wp_postmeta alt
    ON alt.post_id = a.ID AND alt.meta_key = '_wp_attachment_image_alt'
  WHERE a.post_type = 'attachment'
    AND a.post_mime_type LIKE 'image/%'
    AND (alt.meta_value IS NULL OR TRIM(alt.meta_value) = '')"

Replace wp_ with your table prefix. That lists every image in the library, including old uploads nothing uses. To narrow it to the main images of products and variations, join against _thumbnail_id. The query finds empty fields only. Merchlint also counts a field that holds just a filename, a random code or digits as missing.

How to fix it

  1. Describe the product as you would to somebody who cannot see it. “Gray wool throw with fringed edge, folded on a bench” beats “wool throw gray buy cheap”.
  2. Do not repeat the product name on every image of the same product. Five identical alt texts help nobody; say what each photo actually shows—front, detail, in use, scale.
  3. Genuinely decorative images get alt="", deliberately empty. That tells a screen reader to skip it, which is the correct behavior and is different from the attribute being missing.
  4. Do not keyword-stuff. Alt text is read out loud to people. A list of search phrases is a bad experience and has not helped rankings for many years.
  5. Fix the import, if the images arrived without alt in bulk. Most product feeds carry a description field that can map straight to it.

When it’s a false alarm

  • A purely decorative image. Rare as a product’s main image. An empty field is correct for a decorative image, but Merchlint cannot tell it apart and reports the empty field.
  • WooCommerce 9.5 and later, and themes that generate alt from the product title at render time. The stored field is empty and the page shows the product name. Check one product’s source before working through the list: there the finding is an improvement to make, not a defect—your own description of the photo still says more.

How Merchlint finds it

Merchlint reads _wp_attachment_image_alt for the main image of every published product and for each variation’s own image. Gallery images are not checked. An empty field counts as missing, and so does a field that holds only a filename, a random code or digits.

It reports the image, not the product. That is deliberate: one photo often belongs to several products and is fixed once, so reporting it per product would turn a single repair into a long list and make the report look worse than the work actually is.

The finding shows the image, what the field holds, why that counts as missing, and one product that uses the image.

This check reads the field, not the rendered page. The free Storefront Scan does open one product page and, when it shows the product name in place of the empty field, lists the images as a note rather than a defect.

Confidence: F—fact from the database. The field holds a description, or it does not.

This check runs in the free version, on every product’s main image, with no cap.

Run this check on your store

Doesn't match what you see in your store? Email us—we read every message. contact@merchlint.com