DEV Community: Benjamin Oats

Bulk Alt Text for WordPress & WooCommerce: A Demo

Benjamin Oats — Tue, 14 Jul 2026 10:17:25 +0000

Bulk Alt Text for WordPress & WooCommerce: A Demo

If you run a WooCommerce store with more than a handful of products, writing alt text by hand stopped being realistic a long time ago. Every product has a main image, usually a gallery, often variation images, and the media library grows every time you add a line. Describing all of that manually is the kind of job that sits on a to-do list for two years and never gets done.

So instead of describing the problem again, here's a demo of fixing it in bulk — scanning a media library, generating SEO-friendly alt text for WordPress and WooCommerce images, and applying it without editing each product one at a time.

Why bulk alt text matters for WooCommerce

On a store, alt text isn't a nicety — it's part of how products get found. Google Images is a genuine discovery channel for physical products, and it relies heavily on how each image is described. A product photo with no alt text, or with IMG_3391 sitting in the field, is a product that's harder to find for someone searching for exactly what you sell.

There's an accessibility side as well. WCAG guidelines expect meaningful images to carry a text alternative, and for e-commerce that's not just compliance box-ticking — a shopper using a screen reader needs to know which colourway or style they're looking at. Good alt text serves the customer and the crawler at the same time.

The catch is always volume. One product is easy. Four hundred products, each with several images, is where the manual approach collapses. That's the specific problem bulk generation solves.

What the demo walks through

The video runs through the core workflow. Here's the same sequence in writing so you can follow along or skim to the part you need.

1. Scan the media library

Rather than working page by page, the plugin scans your whole WordPress media library and surfaces every image, flagging the ones with missing or weak alt text. For a store, this is the moment you see the true size of the backlog — usually larger than expected, because product imports rarely bring alt text with them.

2. Generate alt text in bulk

Instead of typing a description into each image, the plugin generates alt text across the batch. The descriptions are written to be readable and specific — the kind of plain-language description a person would write about what the image actually shows — rather than a keyword dump. That readability matters, both for accessibility and because search engines have long since stopped rewarding stuffed alt attributes.

3. Review before you apply

This is the step that keeps you in control. You're not blindly trusting output across your entire catalogue. You review the generated descriptions, adjust anything that needs a human touch — a specific model name, a material, a detail the model couldn't infer — and then apply. On a store, a quick pass to check that product-specific terms are right is well worth the few minutes.

4. Cover WooCommerce product images

Product images, gallery images, and the media attached to your listings all get handled in the same pass, so your storefront isn't left with described blog images and undescribed products. That consistency is the whole point: image SEO works best when it's applied across the catalogue, not patchily.

5. Try it before committing

The demo also shows that you can try a batch of free generations without creating an account, which is a sensible way to see the quality on your own images before deciding whether it fits your workflow.

A practical order of operations for a store

If you're staring at a large catalogue, don't try to do everything at once.

Start with your best-selling and highest-traffic products — the ones where image search visibility has the most direct revenue impact. Move on to seasonal or campaign products that you want ranking ahead of a push. Then work through the long tail. Mark genuinely decorative images (badges, layout icons) as empty rather than describing them. And once the back catalogue is clean, keep new product uploads described as they go up, so you never rebuild the backlog.

Frequently asked questions

How do I add alt text to WooCommerce product images in bulk?

Use a plugin that scans your media library and generates alt text across a batch, rather than editing each product. The workflow in the demo — scan, generate, review, apply — lets you handle a whole catalogue in a fraction of the time manual editing would take. You can start with the OpptiAI Alt Text plugin and generate a free batch to check the quality on your own products first.

Does WooCommerce add alt text to product images automatically?

No. WooCommerce uses the alt text stored on the image in the WordPress media library, and it doesn't generate that text for you. If you upload a product image without writing alt text, it stays blank — which is exactly why stores accumulate so many undescribed product images over time.

Will bulk-generated alt text hurt my SEO?

Not if it's readable and accurate, which is what to check during the review step. The risk with alt text has never been "too much automation" — it's stuffed, repetitive, or meaningless descriptions. Generated alt text that plainly describes what each image shows is exactly what Google wants, and reviewing before you apply keeps the quality where it should be.

See it on your own images

The fastest way to judge bulk alt text is to run it on your own catalogue and read the results.

Try a free batch with the OpptiAI Alt Text plugin, or start with a free image SEO audit to see how many of your product images are missing alt text before you begin.

Is Missing Alt Text Quietly Hurting Your WordPress SEO?

Benjamin Oats — Tue, 14 Jul 2026 10:17:20 +0000

Is Missing Alt Text Quietly Hurting Your WordPress SEO?

Nobody sets out to publish images with no alt text. It happens anyway. You upload a photo mid-draft, you're focused on the headline, you hit publish, and the alt field stays empty. Repeat that a few hundred times over a couple of years and you end up with the most common image SEO problem on WordPress: a site full of pictures that search engines can't read.

I put together a short video on exactly this, because the scale of it surprises people. Missing alt text on WordPress isn't a niche accessibility footnote — it's a quiet drag on your image SEO, and most site owners have no idea how many of their images are affected.

Why missing alt text hurts WordPress SEO

Alt text is the plain-language description attached to an image. Its first job is accessibility: a screen reader reads it aloud so someone who can't see the image still gets the information. Its second job is comprehension for machines. Google's crawler can't look at a photo the way you can. It leans on the file name, the surrounding text, captions, and — importantly — the alt attribute to work out what the image shows.

When the alt attribute is empty on a content image, you remove one of the clearest signals Google has. You're asking it to guess. On a product page, that's the difference between ranking in Google Images for "navy linen shirt" and not showing up at all. Image search is a real traffic channel, especially for stores, recipe sites, and anything visual, and it runs almost entirely on how well your images are described.

There's a newer reason to care, too. AI search tools and assistants that summarise the web also read alt text to understand what a page contains. If your images are invisible to those systems, your site is a little more invisible in the places people are increasingly starting their searches.

Why it builds up without you noticing

The reason this problem is so widespread on WordPress is that nothing forces you to fix it. WordPress will happily publish an image with an empty alt field and never warn you. There's no red flag in the editor, no nag in the dashboard.

So it accumulates in a few predictable ways. Older blog posts from before you cared about image SEO still sit there with blank fields. Bulk imports and migrations drop alt text entirely. WooCommerce stores end up with product galleries, variation images, and category thumbnails that never had descriptions written. And a surprising amount of "alt text" is really just a leaked filename — IMG_4821 or product-photo-final-2 — which is arguably worse than nothing because it looks filled in.

The result is a site that feels finished but is leaking image search visibility on almost every page.

How to check where you actually stand

Before you fix anything, get a real number. Guessing "probably a few" is how sites end up with thousands of undescribed images.

Run a public-page scan. Start with what crawlers already see — your homepage, key landing pages, and top articles. A free image SEO audit will crawl your public pages and email you a report showing missing alt text, generic descriptions, and filename-style alt text, grouped so one repeated icon doesn't drown out the rest.
Look at the pattern, not just the count. Is the problem concentrated in old blog posts? WooCommerce products? A theme icon repeated across every page? The shape of the problem decides the fix.
Separate decorative from meaningful. Dividers, background flourishes, and repeated UI icons should have empty alt text (alt="") on purpose. Content images — photos, screenshots, product shots, charts — need real descriptions. Don't waste effort describing a decorative swirl.
Prioritise pages that already earn traffic. Fix product and service pages and your best-performing articles first. Missing alt text there has the clearest commercial cost.

Fixing it at scale without losing a weekend

Fixing a dozen images by hand is fine. Fixing two thousand by hand is not going to happen, which is why these problems persist for years.

This is the gap the OpptiAI Alt Text plugin is built to close. It scans your entire WordPress media library, scores every image so you can see the extent of the problem, and generates SEO-friendly, human-readable alt text you can review and apply in bulk rather than one upload at a time. It covers standard media and WooCommerce product images, and it's built so you can keep a hand on the wheel — you're approving descriptions, not blindly trusting them.

The workflow that works well is: audit your public pages to size the problem, clean the library in bulk so your back catalogue is fixed at the source, then let new uploads get described as they come in so the gap never reopens.

Frequently asked questions

Does missing alt text actually affect Google rankings?

For image search, yes — clearly. Alt text is one of the main ways Google understands what an image shows, so missing it directly limits your visibility in Google Images. For regular page rankings the effect is more indirect: better-described images improve relevance signals and accessibility, both of which support the page overall. It's not a magic ranking switch, but on an image-heavy site the cumulative effect is real.

How do I know how many images on my site are missing alt text?

Run a scan rather than checking pages manually. A free image SEO audit crawls your public pages and reports the count and the worst-offending pages. For a complete picture including older media-library uploads that aren't currently on a public page, a plugin that scans the library directly will give you the full total.

Is it worth adding alt text to images on old blog posts?

If those posts still get traffic or rank for anything, yes. Older content is often where the biggest backlog sits, and it's frequently your highest-authority pages. Fixing alt text there is low effort for a page that already has search equity, so it's usually a better use of time than perfecting brand-new posts.

Start with the number

You can't fix what you haven't measured. Get a real count of how many images on your site are missing or weak on alt text, then decide whether that's a manual afternoon or a job for a bulk workflow.

Run your free image SEO audit, or if you already know the backlog is large, scan and fix your whole library with the OpptiAI Alt Text plugin.

How to Check Your WordPress Image SEO in 60 Seconds

Benjamin Oats — Tue, 14 Jul 2026 10:17:18 +0000

How to Check Your WordPress Image SEO in 60 Seconds

Most people assume their image SEO is roughly fine. Then they actually check, and the number is worse than they expected — dozens or hundreds of images with no alt text, generic descriptions, or filenames sitting in the alt field. The gap between "probably fine" and "actually measured" is where a lot of image search traffic quietly disappears.

The good news is that getting the real number doesn't take a plugin install or an afternoon. You can check the state of your WordPress image SEO in about a minute. Here's the short video, then a walk through what the check looks at and how to act on it.

What a 60-second image SEO check actually looks at

A quick check works by crawling your public pages — the ones a search engine already sees — and reading the alt attribute on every visible image. In under a minute you get a snapshot of the problems that matter most for image SEO:

Missing alt text — images with an empty or absent alt attribute, which are effectively invisible to Google Images.
Generic alt text — descriptions like image, photo, or logo that technically fill the field but tell a crawler nothing.
Filename-style alt text — leftovers like IMG_2048 or banner-final-v3 that leaked in from the upload and read as noise.
Alt text that's too short or too long — a single word rarely describes an image, and a paragraph-length alt is usually keyword stuffing.
The worst-offending pages — where the problems cluster, so you know where to start.

The point of the 60-second version isn't to be exhaustive. It's to replace a guess with a number fast enough that you'll actually do it.

How to run the check

Start the free audit. Head to the free image SEO audit and enter your site. It crawls from your homepage and sitemap where one is available.
Let it scan your public pages. It reads the visible images the way a crawler would, scoring each one against the checks above.
Get the report. You'll receive a PDF by email with an overall score, issue counts, your highest-priority pages, and grouped examples so a single repeated icon doesn't hide everything else.
Read it as a triage list, not a to-do list. You don't need to fix every image today. You need to know the size and shape of the problem.

That's the whole loop. The scan is public-page based on purpose — it shows exactly what search engines can see right now, which is the most honest starting point.

Reading your results without panicking

A first scan can look alarming, so keep some perspective.

A high count of missing alt text is normal, not a sign you've done something wrong — WordPress never forced you to fill the field. What matters is where the gaps are. Missing alt text on a decorative divider is irrelevant; those images should have empty alt text anyway. Missing alt text on a product photo, a recipe image, or a screenshot in a popular tutorial is the stuff worth fixing, because those images could be earning search traffic.

So when you get the report, sort in your head by business value: commercial and high-traffic pages first, decorative clutter last (or never). A site with 800 missing-alt images might only have 150 that genuinely matter, and knowing that turns an intimidating number into a manageable job.

From a quick check to a permanent fix

A public-page scan tells you what crawlers see today. It won't catch every older upload buried in your media library that isn't currently on a live page, and it can't fix anything for you — it's a diagnostic.

Once you know the pattern, close the loop inside WordPress. The OpptiAI Alt Text plugin scans the full media library, scores every image, and generates readable, SEO-friendly alt text you can review and apply in bulk. Run the quick audit to size the problem, then use the plugin to clear the backlog and keep new uploads described as they go up, so you don't drift back to square one in six months.

Frequently asked questions

How can I check my WordPress image SEO for free?

Use a public-page audit tool that crawls your site and scores the alt text on visible images. The free image SEO audit does this in about a minute and emails you a report. It won't require a plugin install to get the initial snapshot, which is what makes it quick.

Why does the 60-second check only look at public pages?

Because public pages are exactly what search engines crawl, so they're the most accurate picture of what your image SEO looks like to Google right now. A media-library scan is more thorough and catches unused older uploads, but the public-page view is the fastest way to see the problems that are actively affecting search visibility.

What should I fix first after checking?

Start with pages that already get traffic or drive revenue — product pages, service pages, and your best-performing articles. Fix filename-style and missing alt text on those first, mark genuinely decorative images as empty, and leave low-value pages for a later pass. Impact per minute is highest on the pages people already reach.

Get your number

Stop guessing about your image SEO and spend a minute getting the real picture.

Run the free image SEO audit to see where you stand, then clean up your whole library with the OpptiAI Alt Text plugin when you're ready to fix it for good.