Title: Altmend – Find and Fix Image Alt Text
Author: wgs92
Published: <strong>October 12, 2026</strong>
Last modified: October 12, 2026

---

Search plugins

![](https://ps.w.org/altmend/assets/banner-772x250.png?rev=3741137)

![](https://ps.w.org/altmend/assets/icon-256x256.png?rev=3741137)

# Altmend – Find and Fix Image Alt Text

 By [wgs92](https://profiles.wordpress.org/wgs92/)

[Download](https://downloads.wordpress.org/plugin/altmend.0.1.0.zip)

 * [Details](https://wordpress.org/plugins/altmend/#description)
 * [Reviews](https://wordpress.org/plugins/altmend/#reviews)
 *  [Installation](https://wordpress.org/plugins/altmend/#installation)
 * [Development](https://wordpress.org/plugins/altmend/#developers)

 [Support](https://wordpress.org/support/plugin/altmend/)

## 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:

 1. The image block attributes, so the editor shows the right thing.
 2. The `<img>` tag inside your post content — this is the one your visitors actually
    receive.
 3. 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

[⌊The Alt status column in the Media Library, showing four different states.⌉⌊The
Alt status column in the Media Library, showing four different states.⌉[

The Alt status column in the Media Library, showing four different states.

[⌊The Alt text panel in the post editor, with a suggestion and its risk flag.⌉⌊The
Alt text panel in the post editor, with a suggestion and its risk flag.⌉[

The Alt text panel in the post editor, with a suggestion and its risk flag.

[⌊The settings screen.⌉⌊The settings screen.⌉[

The settings screen.

## Installation

 1. Upload the plugin folder to `/wp-content/plugins/`, or install it through the Plugins
    screen.
 2. Activate the plugin.
 3. 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.

Contributors

 *   [ wgs92 ](https://profiles.wordpress.org/wgs92/)

[Translate “Altmend – Find and Fix Image Alt Text” into your language.](https://translate.wordpress.org/projects/wp-plugins/altmend)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/altmend/), check out
the [SVN repository](https://plugins.svn.wordpress.org/altmend/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/altmend/) by [RSS](https://plugins.trac.wordpress.org/log/altmend/?limit=100&mode=stop_on_copy&format=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.

## Meta

 *  Version **0.1.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [accessibility](https://wordpress.org/plugins/tags/accessibility/)[alt tags](https://wordpress.org/plugins/tags/alt-tags/)
   [Alt Text](https://wordpress.org/plugins/tags/alt-text/)[image seo](https://wordpress.org/plugins/tags/image-seo/)
   [wcag](https://wordpress.org/plugins/tags/wcag/)
 *  [Advanced View](https://wordpress.org/plugins/altmend/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/altmend/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/altmend/reviews/)

## Contributors

 *   [ wgs92 ](https://profiles.wordpress.org/wgs92/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/altmend/)