WooCommerce Product Image Alt Text: Find the Missing Ones and Fix Them in Bulk

Most WooCommerce stores have hundreds of product photos and alt text on a handful of them. Products get imported from a CSV, a supplier feed or a migration, and the images arrive with no description at all. This guide shows where WooCommerce keeps that text, how to list every product photo that is missing it, what good product alt text looks like, and how to fill the gaps without editing images one by one.

Why product photos are the alt text that matters most

• Search. Google uses the alt attribute to understand an image and rank it in Google Images, where shoppers look for products by sight. An empty alt leaves that ranking to the file name and the text around the photo.
• Accessibility, and in the EU the law. A screen-reader user cannot buy what they cannot identify. WCAG 1.1.1 (Level A) requires a text alternative for every informative image, and since 28 June 2025 the European Accessibility Act applies to e-commerce services sold to EU consumers (microenterprises with fewer than 10 staff and at most €2 million turnover are exempt).
• Broken images. When a photo fails to load, the alt is what the shopper sees instead.

Where WooCommerce stores product image alt text

WooCommerce does not have its own alt field. Product images are ordinary WordPress media attachments, and the alt lives on the attachment, in the post meta key _wp_attachment_image_alt. The product only points at its images:

Two consequences people trip over:

• You edit the alt in Media › Library (or in the image details when you click the product image in the editor), not in a product field.
• An image reused on several products has one alt. If the same photo serves five color variations, give it a description that is true for all of them, or upload separate images.

How to list every product image missing alt text

With SQL (phpMyAdmin, Adminer or wp db query; replace wp_ with your table prefix). Main images of published products with no alt, or an empty one:

SELECT p.ID AS product_id, p.post_title AS product, a.ID AS image_id, a.guid AS image_url
FROM wp_posts p
JOIN wp_postmeta t ON t.post_id = p.ID AND t.meta_key = '_thumbnail_id'
JOIN wp_posts a ON a.ID = t.meta_value
LEFT JOIN wp_postmeta alt ON alt.post_id = a.ID AND alt.meta_key = '_wp_attachment_image_alt'
WHERE p.post_type = 'product' AND p.post_status = 'publish'
  AND (alt.meta_value IS NULL OR TRIM(alt.meta_value) = '');

Change 'product' to 'product_variation' for variation images. Gallery images are a comma-separated list, so they are easier to check from the media side.

With WP-CLI, every image in the Media Library that has never had an alt saved:

wp post list --post_type=attachment --post_mime_type=image \
  --meta_key=_wp_attachment_image_alt --meta_compare="NOT EXISTS" \
  --fields=ID,post_title,post_parent --format=table

This catches images with no alt meta at all, which is what imports usually produce. An alt that was saved and later cleared is stored as an empty string and needs the SQL version above. post_parent shows the product an image was first uploaded to, when there is one.

8 examples: bad vs good WooCommerce product alt text

More product photo cases are in alt text examples for product photos, and the general rule behind all of them in WCAG 1.1.1 alt text requirements.

Filling hundreds of product images in bulk

Writing these by hand works for twenty products, not for two thousand. Alt Text BYOK is a WordPress plugin that finds every image in the Media Library missing alt text and writes it with an AI vision model, using your own API key (OpenAI, Anthropic, Gemini, OpenRouter and others), so you pay the provider directly, cents per hundred images, with no subscription in between.

• Free version: bulk generation for the whole Media Library and one-click generation per image, no usage limits. Product photos are media, so it covers them.
• Full version ($24.99 one-time): uses the WooCommerce product name as context for product and gallery images, so the alt names the product instead of guessing; writes alt automatically when an image is uploaded, so imports never pile up again; and adds wp alt-text generate --limit=100 to run it from WP-CLI on large catalogs.

Not sure how many images are missing? See WordPress images missing alt text for the store-wide check, including images outside WooCommerce.

← See all products

Terms · Privacy · Refunds (7-day money-back) · Contact