Fix Missing Alt Text After a WooCommerce CSV Import

WooCommerce's built-in product CSV importer has no alt text column, so every product photo it pulls in lands in your media library with the alt attribute blank. If you migrated a catalogue, onboarded a new supplier's product feed, or just bulk-loaded 800 SKUs from a spreadsheet, the images are live, the products are live, and none of the photos say anything to Google Images or a screen reader.

This is one of the quieter WooCommerce SEO problems because nothing looks broken. The store works, the images display, customers can buy. The gap only shows up when you check the Alt Text field directly — and by then it's usually across your whole catalogue, not just a handful of products.

Why the CSV importer leaves alt text out

Open Tools → Import → WooCommerce products (CSV) and map your spreadsheet columns to product fields. There's a column for Name, a column for Regular price, a column for Images — a comma-separated list of image URLs or file paths — but there is no column mapping for alt text, title, or caption on those images. WooCommerce's importer treats the Images field as "attach these files"; it doesn't touch the attachment metadata that alt text lives in.

That's a deliberate scope limit, not a bug. The core importer is built to move product data — price, stock, attributes, variations — reliably. Image metadata was never part of that contract. Some third-party import tools, like WP All Import, do support mapping a spreadsheet column straight to alt text. The native WooCommerce importer does not, and most store owners don't discover that until they've already run the import.

The practical result: whatever alt text existed on those images before the import (usually none, since they came from a supplier's photo folder or a spreadsheet of URLs) is exactly what's on them after the import too. WooCommerce doesn't generate a fallback from the product title either — it leaves the field genuinely empty.

How to tell if your imported products are affected

Before fixing anything, confirm the scope. A few quick checks:

• Go to Media → Library, switch to List view, and look at the Alt Text column. If you imported recently, sort by upload date and scan the batch — blank entries mean no alt text.
• Open a handful of the imported products in Products → All Products and check the featured image and gallery image fields. If the Alt Text box in the attachment editor is empty, that image is unaffected by anything you did before the import; it's simply never had text set.
• If you've run several imports over time (initial catalogue load, then supplier feed updates), check whether all of them are missing alt text or just the most recent batch. Stores that migrated from another platform often have older images with alt text intact and only the newly imported SKUs are blank — which tells you the gap is import-specific, not a site-wide habit.

For large catalogues, scrolling through the media library isn't practical. An SEO plugin's site audit (Yoast, Rank Math) or a dedicated image SEO scanner will flag pages with missing alt text faster, though you'll still want to confirm which images came from the CSV import specifically if you're trying to isolate the cause.

Fixing the gap: a practical walkthrough

1. Identify the affected batch. Note the import date, or filter products by the category/attribute you used to tag the imported SKUs (many store owners add a temporary tag like csv-import-2026-07 for exactly this reason — if you didn't, sort media by upload date instead).
2. Decide your alt text pattern before you start. For a product catalogue, the fastest reliable pattern is: product name + one distinguishing attribute (colour, material, angle) + product type. For example, "Forest green wool jumper, front view" rather than just "jumper" or the bare product name repeated on every image.
3. Pull the source data back out, if you still have the original spreadsheet. Your CSV already has clean product names and attributes — reuse them rather than retyping. This is the fastest path for a large batch: the descriptive text you need per image is usually one column away from the Images column that caused the problem.
4. Choose manual or bulk. Under roughly 50 affected images, editing each attachment's Alt Text field directly in the media library is realistic. Past that, manual editing turns into hours of repetitive work, and a bulk tool that reads the product/attachment context and writes descriptive alt text in one pass is the more realistic option.
5. Re-run your audit after fixing. Check the Media Library Alt Text column again, or re-scan with your SEO plugin, to confirm the batch is actually clear rather than partially done.

Preventing the same gap on your next import

The CSV importer's behaviour won't change, so the fix is process, not configuration. Two options work:

Import first, generate alt text second, as a standing step. Treat "run alt text generation on the newly imported batch" as the last step of every CSV import, the same way you'd treat "check stock levels imported correctly." Tag the batch during import (a temporary category or attribute works fine) so you can isolate exactly which images need attention afterwards.

Switch to an importer that supports an alt text column. If you're doing frequent supplier feed imports, a plugin like WP All Import lets you map a spreadsheet column straight to the alt text field, so the gap never opens in the first place. This is worth the switch if CSV imports are a recurring part of your workflow rather than a one-off migration.

Either way, the underlying lesson is the same: WooCommerce's core importer is a data-migration tool, not an image SEO tool, and treating it as the latter is what creates the backlog.

Frequently asked questions

Does WooCommerce's CSV importer support an alt text column?

No. The native WooCommerce product CSV importer maps columns for product data — name, price, stock, attributes, images — but has no field for alt text, title, or caption on the images it imports. Whatever alt text state the source images were in before import (usually blank) is what they'll have afterwards. Third-party import plugins such as WP All Import do support mapping a column directly to alt text, so if you import product feeds regularly, that's worth considering as a replacement for the native tool.

Can I add alt text during a WooCommerce CSV import instead of afterwards?

Not with the built-in importer's interface. Some stores work around this with a developer hook — the woocommerce_product_import_before_process_item filter runs during import and can be used to set attachment metadata programmatically, including alt text, if you're comfortable adding a small snippet to your theme's functions file or a site-specific plugin. Without custom code, the practical approach is to treat alt text generation as a follow-up step immediately after each import rather than part of the import itself.

Will missing alt text on imported product images actually hurt my SEO?

It won't break anything visibly, but it's a real, ongoing cost. Product images without alt text are effectively invisible to Google Image Search, which is a meaningful discovery channel for ecommerce — someone searching for "green wool jumper front view" will never surface your product if the image carries no description. It's not a penalty in the sense of hurting your existing rankings, but it's a missed channel that compounds the longer a catalogue goes unaddressed, especially for stores that rely on organic image search for a chunk of their traffic.

Fix the gap on your catalogue

If a CSV import — or several — has left your product images without alt text, the OpptiAI Alt Text plugin generates descriptions for your existing WooCommerce catalogue, including gallery and variation images, with a review step before anything saves. The free image SEO audit will tell you exactly how many of your images are affected before you commit to fixing them.