Description
Most alt text plugins generate text. Altmend is built around the harder half of the problem: making the fix actually land on the page.
Why that distinction matters
An image block is a static block. WordPress serves the markup stored in your post, not the alt text stored on the attachment. A plugin that only updates the attachment will show you a success message while your front end keeps serving alt="".
Altmend writes to all three places that matter:
- The image block attributes, so the editor shows the right thing.
- The
<img>tag inside your post content — this is the one your visitors actually receive. - The attachment record, so future uses of the same image inherit it.
It never writes without your approval
This is a deliberate design decision, not a missing feature.
Across 39 images reviewed by hand, one class of error survived every prompt improvement we tried: the model would sometimes leave out something occupying a large part of the frame — buildings covering 25–30% of a photo, for example. There is no reliable automatic way to detect that omission, so a fully automatic mode would silently publish incomplete descriptions on your live site.
So Altmend suggests, flags its own uncertainty, and waits. You approve, edit, skip, or mark the image decorative, one image at a time.
Start with no API key and no cost
The first thing you get costs nothing and needs no account. Altmend scans the alt text you already have and flags the common problems: file names like DSC_01234.jpg, generic text like “image”, keyword stuffing, redundant openings such as “This is an image of”, markdown that leaked in from a paste, and text that is simply too long for a screen reader.
That scan runs entirely on your server. No API calls, no key, instant results in the Media Library.
Decorative images are your call, not the plugin’s
Whether an image should have an empty alt attribute depends on how you are using it, not on what the image contains. A marble texture used as a background should be empty; the same file used to illustrate a product’s material should not be. Altmend pre-selects an answer and asks you to confirm it.
What it does not do
- No overlay, toolbar or widget on your front end. Those do not fix the underlying markup.
- No “make my site accessible” claim. Content fixes are one part of accessibility, not all of it.
- No changes to your content without your approval.
- No colour-contrast or theme-level fixes. Those are code problems, and this plugin stays out of them.
Requirements
The image scanner in the editor works with the block editor, covering image, cover, media & text, and gallery blocks. Classic editor content is handled when the alt text is written back.
External services
The free audit does not contact any external service. It runs entirely on your server, and the plugin sends nothing anywhere unless you configure a provider and click a button.
AI suggestions are opt-in. To use them you supply your own API key for a service of your choice. Altmend ships with no provider configured and no keys of its own.
When you click “Suggest alt text” for an image, the plugin sends that single image, resized to a mid-size thumbnail, to the API endpoint you configured, together with the instruction prompt. Nothing else is transmitted: no post content, no other media, no user data, no site information, no telemetry. The request happens only on that click — there is no background scanning and no call-home behaviour.
The plugin author does not operate a proxy or relay and never receives your images, your key, or any data from your site.
Any OpenAI-compatible vision endpoint works. Examples of services you might choose, with their terms and privacy policies:
- OpenAI — https://openai.com/policies/terms-of-use and https://openai.com/policies/privacy-policy
- Anthropic — https://www.anthropic.com/legal/consumer-terms and https://www.anthropic.com/legal/privacy
- Google (Gemini) — https://ai.google.dev/gemini-api/terms and https://policies.google.com/privacy
- Alibaba Cloud Model Studio (DashScope) — https://www.alibabacloud.com/help/en/legal/latest/alibaba-cloud-international-website-product-terms-of-service and https://www.alibabacloud.com/help/en/legal/latest/privacy-policy
You are responsible for confirming that you are allowed to send your site’s images to whichever provider you choose.
Screenshots



Installation
- Upload the plugin folder to
/wp-content/plugins/, or install it through the Plugins screen. - Activate the plugin.
- Optional: open Settings Altmend and enter your API endpoint, key and model if you want AI suggestions. You can skip this and still use the free audit.
Where things live
- Media Library — the “Alt status” column shows what needs attention. This column never calls an API.
- Post editor — open the “Alt text” panel on the right to work through the images in a post one at a time.
FAQ
-
Do I need an API key?
-
No. The alt status column and the audit of your existing alt text work without one and cost nothing.
-
Will it change my images or posts on its own?
-
No. Suggestions are stored separately. Your post content and attachment alt text change only when you explicitly approve something.
-
Why not just generate alt text automatically?
-
Because the automation cannot yet tell when it has left something out, and a wrong description on a live page is worse than an empty one. For a background image, the correct answer is an empty alt attribute — something an automatic generator will rarely decide on its own.
-
Does it support the block editor?
-
Yes, and it covers image, cover, media & text, and gallery blocks.
-
What happens if I change the model?
-
Any OpenAI-compatible vision model works, but behaviour varies — usually in how much detail a model includes, not in correctness. Test on a few images before processing a large library.
-
Will my edits be lost if I save the post afterwards?
-
No. When you approve a suggestion, the plugin also updates the block attributes in the editor, so the editor and the database hold the same value and saving is a no-op.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Altmend – Find and Fix Image Alt Text” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Altmend – Find and Fix Image Alt Text” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.0
- First release.
- Free audit of existing alt text: file names, generic text, keyword stuffing, redundant openings, markdown, over-length.
- AI suggestions with per-image approval in the post editor.
- Writes approved fixes to block attributes, post content, and the attachment record.
- Decorative-image confirmation.
- Records every generated suggestion and every change, including the model and prompt version used.
