WooCommerce Image Alt Text: The Complete Guide
WooCommerce runs on WordPress, and that shapes everything about how image alt text works on your store: where it is stored, why product imports so often end up with none, and what your realistic options are for fixing a whole catalog at once. This guide walks through the manual method, the bulk methods, and a generate-and-import workflow you can run today.
Why alt text matters for WooCommerce stores
Image search brings buyers. Product photos that rank in Google Images send highly motivated visitors to product pages — people who searched for exactly what you sell and clicked a picture of it. Google determines what an image shows largely from its alt text and surrounding content. Stores that write specific, honest alt text for every product image give Google a reason to surface those images; stores that skip it compete only on page text.
SEO plugins expect it. If you run Yoast SEO, Rank Math, or a similar plugin, you have seen the analysis item asking for images with alt text and a focus keyword. Those checks exist because missing alt text is a genuine gap in how search engines read your pages — the plugins are simply measuring it for you.
Accessibility and legal risk. Screen reader users depend on alt text to shop your store, WCAG 2.1 requires text alternatives for meaningful images, and e-commerce sites are frequent targets of ADA accessibility lawsuits. Complete alt text is one of the highest-impact, lowest-cost accessibility fixes a WooCommerce store can make.
Where alt text lives in WordPress and WooCommerce
In WordPress, every uploaded image is an attachment — its own entry in the media library — with an alt text field stored in the database. WooCommerce product images are no exception: the main product image and every gallery image are media library attachments, so they each carry their own alt text. This has two consequences:
- Alt text survives theme and plugin changes, because it lives with the attachment, not your theme.
- The same image reused across several products shares one alt text — so write it for the image itself, not for one specific product page.
One caution from experience: if you import products with a CSV, the images come in but their alt text fields usually arrive empty. Large WooCommerce catalogs are full of silently empty alt text for exactly this reason — it is worth checking a sample of your oldest imports.
Adding alt text manually
From the product editor
Open the product, hover a gallery image, click the edit (pencil) icon, and fill in the Alternative text field in the attachment details panel. The main product image can be edited the same way. Save when you are done.
From the media library
- Go to Media → Library and switch to list view if you are in grid view.
- Click an image to open its attachment details.
- Enter the alt text in the Alternative Text field on the right.
- Close and move to the next image.
Both routes edit one image at a time. A catalog of 300 products with four images each is 1,200 passes through the same dialog — and WordPress' built-in bulk actions in the media library cover delete and a handful of other operations, but not alt text. That gap is why bulk alt text is a known pain point for WooCommerce stores.
Bulk options compared
Spreadsheet export/import via a plugin. Products and attachment plugins can export your media (or products) to a spreadsheet, let you fill the alt text column, and push the changes back. This works well and keeps everything reviewable — the cost is the writing itself.
Direct database updates. Developers can script updates to _wp_attachment_image_alt or use WP-CLI. Powerful, but easy to get wrong, and it bypasses any review of what the text actually says. Generate the text first, review it, then let a script write it.
Generate alt text from image URLs, then import. This is where a dedicated generator fits: paste your product image URLs, get descriptive alt text for each, export a CSV, and bring it into WordPress through your spreadsheet plugin of choice — or paste values directly into the media library. The steps below show the workflow with the free generator on this page.
Bulk-generate your WooCommerce alt text
Paste product image URLs, generate descriptive alt text in bulk, and export a CSV for import. Free to start.
Try it free
Paste image URLs (one per line, max 50) — or upload local images below.
WooCommerce alt text FAQ
Where does WordPress store image alt text?
Alt text for every image in the WordPress media library — including all WooCommerce product and gallery images — is stored in the wp_postmeta table under the meta key _wp_attachment_image_alt. That is why it survives theme changes and why most bulk-edit plugins write directly to that field.
Is there a character limit for alt text in WordPress?
WordPress does not enforce one, so the field will accept paragraphs if you paste them. The practical limit comes from screen readers, which read the whole string aloud: one descriptive sentence of around 125 characters is the sweet spot. Long explanations belong in the product description or a caption, where sighted readers can benefit too.
Alt text vs. image title vs. caption vs. description — which one matters?
Alt text is the text alternative read by search engines and screen readers — it is the field that matters for SEO and accessibility. The title shows as a tooltip on hover in some browsers, the caption is visible text under the image, and the attachment description is mostly internal. If you only fill in one field, make it alt text.
Does the WooCommerce product CSV importer set alt text?
The built-in importer's Images column pulls images into a product by URL, but it generally will not write alt text for them — imported products typically end up with empty alt fields. That is one of the most common reasons WooCommerce catalogs have thousands of images with no alt text. The practical fix is to generate alt text separately and import it with a spreadsheet or bulk-edit plugin.
Will editing alt text break anything on my store?
No. Alt text is pure metadata: changing it does not touch the image file, the URL, or the product data. The updated text appears immediately on the front end, and you can revise it as often as you like with no caching concerns beyond your usual page cache.
Do decorative images need alt text?
Meaningful images — product photos, variant shots, diagrams, size charts — always need descriptive alt text. Purely decorative graphics can use an empty alt attribute (alt="") so screen readers skip them. In a WooCommerce store, almost everything in the product gallery is meaningful, so treat empty alt text as a to-do item, not a choice.
Fix your catalog's empty alt text
The free generator covers 25 images at no cost — enough to clear a category today. Larger catalogs are what the paid plans are for.
Want to sharpen what the generator produces? Read the alt text best practices guide.