Scan Your WordPress Media Library for Missing Alt Text

If you're checking alt text by opening posts one at a time, you're auditing the wrong list. Your published pages only show the images that made it into content. Your media library holds every image you've ever uploaded — including the ones sitting in product galleries, page builders, widgets, and old drafts that never got a second look.

I made a short video showing why starting from the media library, not the post editor, is the faster way to find the real scale of a missing alt text problem.

Why page-by-page checking undercounts the problem

Most people who go looking for missing alt text start where the content lives: they open a post, scroll through it, and check each image against the description in the editor. That works for a handful of pages. It falls apart the moment your site has any real history behind it.

Here's the gap. A WordPress media library typically holds far more files than appear in your visible content. Images get uploaded for a page that was never published, attached to a product that was later deleted, embedded in a widget that doesn't render in the block editor's image list, or duplicated across sizes when a theme regenerates thumbnails. None of that shows up if you're reading posts top to bottom. You can check every published page on your site and still miss a large share of what's actually in your media library.

There's a second reason page-by-page checking is slow: it's stateful in your head, not in a tool. You have to remember which posts you've already checked, which images you already fixed, and which ones you skipped because you weren't sure. That tracking overhead is where most manual audits quietly stop halfway through.

What a media-library-first scan actually gives you

Flip the starting point and the problem becomes countable. Instead of asking "does this page have good alt text?" one page at a time, you ask "how many of my images, across the entire library, have no alt text at all?" once.

That single number changes how you plan the work. If a scan comes back with 40 missing images out of 600, that's a task you can finish this afternoon. If it comes back with 4,000 out of 12,000, that's a different kind of project, and it tells you not to bother fixing alt text by hand — you need a process that works at that scale, not a checklist.

A library-first scan also naturally sorts images into groups that page-by-page checking can't: images with no alt text at all, images with generic or filename-style alt text (IMG_4021.jpg copied straight into the field), and images that already have a real description. Seeing those three buckets separately tells you where to spend your first hour.

Running the scan

1. Start from Media, not Posts. Open your WordPress media library view rather than clicking into individual pages. This is the full inventory, not a filtered subset.
2. Sort by alt text status, not upload date. You want to see missing and weak alt text grouped together, not scattered across pages of chronological uploads.
3. Note where the gaps cluster. In most sites, missing alt text concentrates in one or two sources — a product import, a theme's demo content, or images added directly through a page builder that bypasses the standard media fields. Once you spot the cluster, you know where a bulk fix will have the most impact.
4. Cross-reference against your live pages. A free image SEO audit checks what's actually rendering on your public pages, which is a useful second pass after the library scan — it confirms the images search engines can see, not just the images sitting in your database.
5. Re-run the scan after any bulk edit. A number without a before-and-after comparison doesn't tell you whether the fix worked. Treat the missing-count as a metric you check again, not a one-time report.

Turning a scan into fixed images

Finding the gap is the easy half. Writing hundreds or thousands of accurate descriptions by hand is where most audits stall — nobody has a free afternoon for that, so the spreadsheet of "images to fix" sits untouched. The OpptiAI Alt Text plugin is built for that second half: it scans the whole media library the same way, then drafts alt text for the images that need it, which you review before anything saves back to WordPress. The scan tells you the size of the job; the plugin is what makes clearing it realistic in one sitting rather than one image at a time.

Frequently asked questions

Why does my WordPress media library have more images than my published pages show?

Uploads accumulate from more places than your visible content: deleted drafts, unused product images, thumbnail regenerations from theme or plugin changes, and files added through page builders that don't always register in the standard content editor. Over years of site activity, this backlog can be substantially larger than what's currently live. A media-library scan counts all of it; reading through your posts only counts what made it to a published page.

What's the difference between missing alt text and weak alt text?

Missing alt text means the field is empty — nothing for a screen reader or search engine to read. Weak alt text means the field has something, but it's not useful: a filename like IMG_2931, a single generic word like "image", or text copied from the page title regardless of what the picture shows. Both hurt image SEO and accessibility, but they need different fixes — missing alt text needs a description written from scratch, weak alt text needs a rewrite.

How often should I re-scan my WordPress media library for alt text gaps?

Scan again after any bulk import (new products, a theme migration, a content migration from another platform) and periodically otherwise — quarterly is reasonable for an active site. New uploads reopen the gap even after you've cleared it once, so a scan is a check you repeat, not a task you complete permanently.