Use case · Image alt text fixer

Fix 30 missing alt tags in one chat turn.

The agent finds every image without alt text, suggests one based on the image and the post it lives in, lets you review, then writes them all at once.

The problem you actually have

Missing alt tags hurt accessibility (screen readers skip the image entirely), hurt SEO (Google uses alt as a relevance signal for image search), and break WCAG 2.1 compliance — which matters increasingly for European businesses subject to the European Accessibility Act.

Fixing them manually means clicking into each attachment, typing alt text, saving, repeating. For a site with 200+ images and partial coverage, that’s an afternoon’s work that nobody actually does.

The right answer is: scan all published posts, list images without alts, generate accurate one-line descriptions, present them as a reviewable table, and write them all in a single batch.

How the assistant solves it

You type the request in plain English inside wp-admin. The agent picks wp_set_image_alt_bulk (plus wp_seo_audit if relevant) and walks the steps below.

  1. You ask: “run an SEO audit and fix the missing alt tags.”
  2. The assistant calls wp_seo_audit, gets the count and a list of attachment IDs that lack alt text.
  3. For each, it generates a one-line factual alt description (subject + context, no keyword stuffing, ≤125 characters as the screen-reader convention requires).
  4. You see a markdown table: image preview · current alt (empty) · suggested alt. You strike out three you don’t like, edit two.
  5. The assistant calls wp_set_image_alt_bulk with up to 30 confirmed alts in one shot. It writes _wp_attachment_image_alt for each.
  6. You get the confirmation: 30 alts written. 4 skipped because the user ID doesn’t have edit_post on that attachment.

Before vs after

Without the assistantWith the assistant
How long~30 seconds per image × 200 images = 90 minutes~2 minutes per batch of 30 including review
QualityVariable — different days, different brain statesOne factual style, derived from post context, ≤125 chars consistently
CoverageYou stop after 20 because it’s tediousWhole site cleared in 7 batches, all logged
WCAG 2.1 compliancePartialEvery image alt-tagged

Where it stops

  • Decorative images (purely aesthetic, no information value) should have empty alts per WCAG. The assistant defaults to writing descriptive alts; if you have decorative images, tell the chat “these are decorative, use empty alts” and it complies.
  • The assistant doesn’t see the actual pixels (no vision call in the loop) — it derives alts from the post the image is attached to, the caption, and the file context. For images with no surrounding context, suggestions are weaker.
  • 30 per call hard cap. Use “do the next batch” to chain.
  • Capability-scoped: upload_files on the user, edit_post on each attachment.

FAQ

Does the assistant actually look at the image?

Not in v1 — it derives alts from textual context (caption, attachment title, parent post). A vision-LLM-based variant is on the roadmap but adds latency and cost; for most use cases the textual context alone produces acceptable alts.

Will it overwrite alt text I've already written?

It only fixes images flagged by wp_seo_audit as missing alts. If you have alt text already, it’s left alone unless you explicitly ask the chat to “rewrite all alts” — which we recommend against unless you really mean it.

What about RankMath / Yoast image SEO scoring?

They’ll re-evaluate and bump up your scores once the alts exist. Re-running wp_seo_audit after the batch confirms the count went down.

Plan?

Admin plan (€29/mo) or Bundle (€39/mo). Free Visitor plan does not include the admin assistant.

Clear every empty alt by Friday.

Free plan, no card. Or read the full admin assistant page.

Start the Admin plan — €29/mo