AI Auto Alt Text Generator

4 mini and legacy GPT-4o mini options) to create meaningful, screen-reader-friendly alt text and SEO-friendly titles for your images. Whether you add a single image, bulk-process your library, or just want a one-click fix in the Media Library, the plugin handles it all – no manual effort required.

This solution is far cheaper than many alternatives because it cuts out the middle-person. You’ll just need to bring your own OpenAI API key.

✨ Key features

• Automatic alt text on upload – set-and-forget accessibility.

• Optional automatic image titles – improve SEO with descriptive titles.

• One-click manual generation – “Generate Alt Text & Title” button in the Media Library.

• Bulk update tool – batch-process existing images, including those that only have filename-based alt text, with a configurable pause between batches.

• Prompt fine-tuning – supply site-wide context and optionally include the image file name.

• Model selection – default to GPT-5.4 nano (fastest & cheapest) or switch to GPT-5.4 mini for higher quality; legacy GPT-4o mini and GPT-5 mini/nano remain available.

• Image size & detail control – choose the resolution and level of visual detail sent.

• Developer-friendly – filters and actions to customise prompts, models and output, plus optional outgoing webhooks.

• WordPress Abilities API – registers a generate-alt-text ability (WordPress 6.9+/7.0) so core AI, agents and automation tools can generate alt text.

• No extra servers – data flows only between your site and OpenAI; nothing is stored off-site.

• Multilingual output – choose English (UK), English (US) or other popular languages. (English US is the default.)

🧭 Where to find the bulk tool

• Tools → Bulk Alt Text Update

• Media → Bulk Alt Text Update (shortcut that redirects to the Tools page)

• Settings → Alt Text Generator includes a button linking straight to the bulk page

🧠 How it works

• When an image is uploaded (or manually chosen), the plugin creates a temporary public URL for that image.

• It sends the image – plus optional context such as the parent post title, your custom site context and the file name – to your selected OpenAI vision model.

• OpenAI returns a concise description.

• Alt text is stored in WordPress’ native _wp_attachment_image_alt field.

• (Optional) The returned title is stored as the attachment post title.

• Nothing is cached or stored on OpenAI’s side; only the final strings live in your database.

Settings overview

• OpenAI API Key – Required to connect to OpenAI.

• OpenAI Model – GPT-5.4 nano (default), GPT-5.4 mini, or legacy GPT-4o mini / GPT-5 mini / GPT-5 nano.

• Image Size to Send – Thumbnail, Medium, Large, or Full.

• Image Detail Quality – ‘Low’ or ‘High’ (Low uses fewer tokens).

• Bulk batch size – Number of images per batch (lower values reduce rate-limit risk).

• Site Context – Optional free-form prompt guidance (brand voice, niche, etc.).

• Send Image File Name – Include file name in the prompt for extra context.

• Automatically Generate Title – Add descriptive titles alongside alt text.

• Use full context for image titles – When enabled, title generation includes site context and file name (uses more tokens).

• Bulk optimiser delay (seconds) – Pause between batches during bulk runs.

• OpenAI request timeout (seconds) – Max wait time for OpenAI responses (10–120s) to reduce timeout failures on slower hosts.

• Output Language – Default English (US). Choose English (UK) for British spellings or another popular language; outputs (alt text and titles) will be generated in the selected language.

• Webhook URL & signing secret – Optionally POST generated alt text/titles to an external endpoint (with an optional HMAC-SHA256 signature) for automation and logging.

Developers

The plugin is extensible via standard WordPress hooks, an outgoing webhook, and the WordPress Abilities API.

Filters

• aatg_alt_text_prompt ( $prompt, $post_ID, $context ) – customise the alt-text prompt.

• aatg_image_title_prompt ( $prompt, $post_ID, $context ) – customise the title prompt.

• aatg_openai_request_payload ( $payload, $context, $messages ) – customise the full OpenAI request (model, messages, reasoning effort).

• aatg_generated_alt_text ( $alt_text, $post_ID ) – filter alt text before it is saved.

• aatg_generated_title ( $title, $post_ID ) – filter the title before it is saved.

• aatg_is_low_quality_alt ( $is_low, $alt, $post_ID ) – control which existing alt text the bulk tool regenerates.

• aatg_webhook_payload ( $payload, $post_ID, $result ) – customise the outgoing webhook body.

• aatg_supported_image_extensions ( $extensions ) – customise which image formats are sent to OpenAI (default: PNG, JPEG, GIF, WebP).

Actions

• aatg_after_alt_text_generated ( $post_ID, $alt_text )

• aatg_after_title_generated ( $post_ID, $title )

• aatg_after_generation ( $post_ID, $result )

Outgoing webhook

Set a Webhook URL under Settings → Integrations & Webhooks to receive a non-blocking JSON POST after each generation. If a signing secret is set, requests include an X-AATG-Signature: sha256=… header (HMAC-SHA256 of the body) so your endpoint can verify authenticity.

WordPress Abilities API

9+ the plugin registers the ability ai-auto-alt-text/generate-alt-text (input: attachment_id ) so WordPress core AI, agents, MCP servers and automation tools can generate alt text programmatically. Execute it with wp_get_ability( 'ai-auto-alt-text/generate-alt-text' )->execute( array( 'attachment_id' => 123 ) ).

External services

This plugin connects to the OpenAI API to generate alt text and (optionally) image titles.

• Endpoint: https://api.openai.com/v1/chat/completions

• When called:

• On image upload (automatic)

• Via “Generate Alt Text & Title” button in Media Library (manual)

• Via Tools → Bulk Alt Text Update (bulk)

• Data sent: image URL, optional file name, optional site context, optional parent post title

• Terms: https://openai.com/policies/terms-of-use

• Privacy: https://openai.com/policies/privacy-policy

If you configure a Webhook URL, generated alt text/titles (and the image URL) are also sent to that endpoint you control.