AI Auto Alt Text Generator
AI Auto Alt Text Generator is a lightweight, privacy-conscious plugin that uses OpenAI vision-capable models (defaulting to GPT-5.4 nano, with GPT-5.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 On WordPress 6.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.
Top keywords
- alt28×3.03%
- alt text25×2.71%
- text25×2.71%
- image19×2.06%
- openai18×1.95%
- title15×1.63%
- post14×1.52%
- aatg11×1.19%
- bulk11×1.19%
- context11×1.19%
- id10×1.08%
- gpt-59×0.98%
Bubuku Media Library
Bubuku Media Library helps content and marketing teams audit, monitor and optimize images in WordPress. Track file sizes, identify missing alt text, export reports, receive email summaries and connect AI assistants through MCP. New in version 1.3.0: Bubuku Media Library includes an MCP Server that allows compatible AI assistants and developer tools to interact with your WordPress Media Library through a secure endpoint with role-based permissions. You can: Sort the Media Library by file size to easily identify large files. Filter images that don’t have alternative text (alt text). Use size-based filters (for example: optimal size, medium size, large size) to prioritize which images to optimize first. Run a Bulk Action in the Media Library to calculate file sizes for existing uploads. Export CSV reports including file size, format (MIME type), URL, alt text, image date, post title and post URL — ideal for audits or sharing with your team. See a summary of your Media Library in a dashboard widget, including how many images are heavy or missing alt text. Configure weekly or monthly email reports so you can monitor the optimization status of your images without logging into WordPress. Connect MCP-compatible AI assistants to your Media Library using role-based permissions and configurable abilities. More information (in Spanish) about how the plugin works: How to know if we have to reduce weight to the image and Alt SEO attribute AI & MCP Integration Bubuku Media Library includes a built-in MCP Server that allows compatible AI assistants and development tools to securely interact with your WordPress Media Library. Available MCP abilities include: Listing media library attachments. Reviewing image metadata and alt text coverage. Exporting media audits to CSV. Accessing media library summary metrics. Triggering reports and diagnostics. Managing media accessibility workflows. Each ability can be enabled or disabled individually and restricted to a minimum WordPress role. This allows you to safely connect AI assistants like Claude Desktop, Codex, Cursor and other MCP-compatible clients to audit images, review missing alt text, generate reports and automate media management workflows, while keeping permissions under your control. Typical use cases include: Finding images without alt text. Exporting media audits for content reviews. Checking image size distribution. Generating accessibility reports. Integrating WordPress media workflows with AI assistants. Automating repetitive media library review tasks. Quick Start From your server (SSH), move the plugin folder to the plugins directory: wp-content/plugins/bubuku-media-library/ Activate the plugin via the WordPress admin or using WP-CLI: wp plugin activate bubuku-media-library (Optional) Run the bulk action in Media > Library to calculate file sizes for existing images. Evaluate results Recommended Tools – Lighthouse (in Chrome DevTools) — Analyze image weight and format, as well as the use of alternative text (ALT). – WebPageTest — Check how images affect real-world load times. – Squoosh — Compare visual quality and file size savings when optimizing images. – WAVE Accessibility Tool — Verify whether images are missing ALT attributes or if the alternative texts are descriptive. Evaluation Guidelines – Identify images without ALT text or with excessive file size before running external tests. – After replacing large images or adding ALT text, repeat your evaluations to confirm improvements. – Evaluate both new and existing content — not only the most recent uploads. – Define an internal size limit (for example, 200 KB per image) and monitor it regularly. – Keep in mind that accessibility also affects SEO and overall user experience. SUPPORT Need help or have a suggestion? Please use the official WordPress.org Support Forum for any issues related to the plugin. Official Website For additional information or to get in touch with the development team, please visit our official website. Like the plugin? Please leave a 5-star review and help others discover Bubuku Media Library. ABOUT BUBUKU_CODE We develop custom solutions for WordPress focused on performance, accessibility, and maintainable code. Our work includes plugins, themes, and integrations designed to improve the daily workflow of marketing and content teams.