
How OpptiAI Alt Text Handles WooCommerce Alt Text: A Complete Walkthrough
A full walkthrough of OpptiAI Alt Text's WooCommerce alt text workflow: featured images, gallery images, and auto-generation on upload.
If you've been reading this series, you know the problem: WooCommerce stores accumulate hundreds or thousands of product images with no alt text, and manually writing descriptions for every featured image, gallery angle, and variation shot isn't realistic. You know alt text matters for Google Image Search, for AI search citations, and for accessibility compliance.
This post shows you exactly how OpptiAI Alt Text handles that problem — from install to completed catalog. No theory, no generalising. This is what the workflow actually looks like on a WooCommerce store.
I built OpptiAI Alt Text, so I'm not a neutral observer here. What I can offer is a transparent walkthrough, including the parts where the AI output needs editing and the cases where you'll want to review and edit the results at any time.
Install and Activation: No API Key Step
One of the design decisions behind OpptiAI Alt Text is that there's no API key to configure. You install the plugin from WordPress.org, activate it, and the dashboard is ready. The AI processing runs through OpptiAI's managed backend — you never need to create an OpenAI account, generate a key, or paste credentials into a settings field.
This matters more than it sounds for WooCommerce setups. If you're an agency installing this on multiple client stores, skipping the API key step on every site saves real time. If you're a store owner who's never touched an API console, you never have to.
What you'll see after activation:
- A new OpptiAI Alt Text menu item in the WordPress sidebar
- The main dashboard showing your media library stats — how many images have alt text, how many don't
- You can try it without an account, then keep going on a free account.
That is enough to evaluate the output quality on your own product images before deciding anything about a paid plan.
The Media Library Workflow
Before getting into WooCommerce-specific handling, here's the core workflow that applies to all images.
Step 1: Select images
From the OpptiAI dashboard, you can select images individually or filter by status — "missing alt text" is the most useful filter for a first pass. For a WooCommerce store, this filter will typically surface the majority of your product catalog.
Step 2: Generate
Click generate. The selected images are sent to the AI backend, which analyses each image and returns a descriptive alt text string. Processing runs in the background — you don't need to keep the tab open.
For a batch of 100 images, expect processing to take a few minutes. The first result arrives in under 60 seconds, but the full batch runs asynchronously so your WordPress admin stays responsive.
Step 3: Edit the results
Generate writes the alt text straight away. You see the image, the saved alt text, and an edit field. You can edit any result at any time.
Most of the time, the generated text is already accurate. For product images specifically, the AI is reliably good at describing what the product looks like: colour, material, shape, visible features. Where you'll want to edit:
- Domain-specific terminology. The AI might describe a "brass-coloured metal fastener" when your product listing calls it a "vintage brass toggle clasp." Your customers search for the second phrase, not the first.
- Brand names and model numbers. The AI can see what a product looks like but can't read your SKU system. If your alt text should include "Oakley Holbrook OO9102" rather than "black rectangular sunglasses," you'll add that when you edit the result.
- Context that isn't visible. A product image showing a cream in a jar looks identical whether it's a moisturiser or a hair mask. The AI describes what it sees; you add what it means.
Step 4: Edit anything that is off
The alt text is already saved. Change a result when the wording is wrong. Leave the ones that describe the image.
WooCommerce-Specific Handling
Here's where WooCommerce stores have a problem that standard WordPress sites don't: every product has multiple image types, and they're stored differently in the database.
Featured images
The main product image — what shows up in shop listings, category pages, and the primary product photo on the product page. OpptiAI processes these the same way it handles any WordPress featured image. The alt text is written to the _wp_attachment_image_alt post meta field.
Gallery images
Product gallery images show different angles, details, or use cases for the same product. A leather bag might have six gallery images: front, back, interior, strap detail, size comparison, lifestyle shot.
OpptiAI processes each gallery image individually. The AI describes what each specific image shows — not just "leather bag" repeated six times, but descriptions that reflect the actual view:
Brown leather messenger bag, front view with flap closed and brass buckle visibleBrown leather messenger bag interior showing padded laptop sleeve and organiser pocketsBrown leather messenger bag being carried over shoulder, showing adjustable strap length
This matters for Google Image Search. Six images with the same alt text are essentially one signal repeated. Six images with distinct, accurate descriptions give Google six opportunities to match different search queries to your product.
How OpptiAI distinguishes image types
When you run a batch on a WooCommerce store, OpptiAI identifies which images are attached to products as featured images and which are gallery attachments. The processing is the same, the AI analyses what each image shows, and you can work through a product's images together rather than jumping between unrelated images.
This grouping makes the review step significantly faster for large catalogs. You see "Product: Brown Leather Messenger Bag" with all six images and their generated alt text, edit anything that is off, then move to the next product.
Auto-Generation on Upload
For stores that add products regularly, the backlog fix is only half the problem. New product images uploaded next week will have the same missing alt text issue unless something handles them automatically.
OpptiAI's auto-generation on upload hooks into the WordPress media upload process. When you upload a new product image — whether through the media library, the block editor, or the WooCommerce product editor — alt text is generated in the background automatically.
The generated text is saved, and you can edit it. For the majority of straightforward product photos, the auto-generated alt text is good enough to leave as it is, and your catalog does not accumulate a new backlog.
Setup: Toggle auto-generation on in OpptiAI Settings. That's it. New uploads are processed automatically from that point forward.
Honest Limitations
No point hiding these — you'll discover them anyway, and knowing upfront helps you get better results.
Highly specialised products. The AI handles common product categories well — clothing, accessories, electronics, homewares, food items. For very niche products (industrial components, specialised medical equipment, technical instruments), the descriptions will be accurate about what's visible but may lack the specific terminology your industry uses. The review step handles this — you edit "cylindrical metal component with threaded end" to "M12 stainless steel hex coupling nut" and move on.
Text-heavy product images. Images that contain significant text (labels, ingredient lists, size charts) are described in terms of what they show visually, but the AI doesn't transcribe the text content into the alt text. If the text on the image is important, you'll want to add it during review.
Very large catalogs. A store with 5,000 products and 15,000 images will take time to process — there's no way around the physics of sending that many images through AI analysis. OpptiAI processes batches in the background and you can run multiple batches sequentially. Plan for the initial bulk processing to happen over a day or two for very large stores, with ongoing auto-generation handling new uploads after that.
Frequently Asked Questions
Is OpptiAI Alt Text free for WooCommerce stores?
The plugin is free to install. You can try it without an account, then keep going on a free account. For most WooCommerce stores with large catalogs, a paid plan will be needed for the initial bulk processing, with the free tier often sufficient for ongoing new uploads after the backlog is cleared.
Will OpptiAI Alt Text work with my WooCommerce theme?
OpptiAI writes alt text to standard WordPress metadata fields — the same fields your theme reads when rendering images. It doesn't modify your theme, inject frontend code, or change how images display. If your theme renders alt text from the standard _wp_attachment_image_alt field (virtually all themes do), OpptiAI's output will appear correctly.
How many images can OpptiAI process per month on a WooCommerce store?
This depends on your plan. You can try it without an account, then keep going on a free account. Paid plans offer higher volumes for stores that need to process larger catalogs. Check the current pricing on oppti.dev/pricing for specifics. The credit counter in the plugin dashboard always shows exactly where you stand.
See for Yourself
The fastest way to evaluate whether OpptiAI Alt Text works for your WooCommerce store is to install it and try it on your own product images. You can try it without an account, then keep going on a free account.
Try OpptiAI Alt Text free on WordPress.org →
Disclosure: OpptiAI Alt Text is built by Ben Oats, the author of this post. This is a product walkthrough, not an independent review — but everything described here is what the plugin actually does, verifiable on install.
Related Posts
WooCommerce Product Photo Swaps Leave Alt Text Stale
Replace a WooCommerce product photo and the old alt text often stays behind, now describing a picture that is no longer there. Here's how to catch it.
How to add alt text to WooCommerce product gallery images
WooCommerce gallery images are separate Media Library attachments, so they often have no alt text. How to check them, what to write, and how to fix a whole catalogue.
WooCommerce Cross-Sell Thumbnails Miss Alt Text
WooCommerce cross-sell and upsell thumbnails often ship with no alt text, because a separate template or widget renders them, not the product gallery.

