Description

AI Alt Text Creator is a complete solution for automating image SEO and accessibility on your WordPress site. It uses Artificial Intelligence to analyze your images and generate descriptive, context-aware Alt Text and Titles.

By connecting to OpenRouter, this plugin bypasses expensive monthly subscriptions, giving you direct access to the world’s best AI models (including Google Gemini, GPT-4, and Claude 3.5) at the lowest possible cost.

🚀 Key Features

One-Click Manual Generation: Instantly generate metadata for individual images directly from the Media Library list view. Perfect for new uploads or refining specific images.

Automated Background Processing: Process your entire back catalog automatically using the built-in Cron scheduler. Configure batch sizes and intervals to suit your server’s capacity.

Context-Aware Descriptions: The AI reads the Title and Content of the post/page the image is attached to. This ensures the generated Alt Text is relevant to your specific article, not just a generic description of the visual.

Global Context: Add custom instructions (e.g., “Always mention our brand name ‘Acme Corp’”) that apply to every image generated.

Smart Error Handling:

Retry Failed: Automatically logs failed attempts. You can retry all failed images with one click from the settings page.

JSON Fixer: A specialized tool to scan and fix images where the AI might have accidentally saved raw code instead of text.

Error Logging: View detailed error logs directly in the “Edit Media” screen if an image generation fails.

Cost Control: You bring your own API key. You pay only for exactly what you use, with no markup.

Format Control: Choose exactly which file types to process (JPG, PNG, WEBP, etc.).

Upgrade

Unlock the ultimate media optimization toolkit with the KooKoo AI Alt Text Creator Pro Addon.

How to Get the Pro Version

You can purchase the Pro Addon directly from Violo.ir. Once purchased, upload and activate the Pro Addon plugin alongside the free version of KooKoo AI Alt Text Creator.

What You Get with Pro

Auto-Generate on Upload: Automatically analyzes and generates image details (Alt, Title, Caption, Description) the moment you upload them to the Media Library.
Media Library Bulk Actions: Select multiple images and generate details in bulk directly from the WordPress Media Library list view.
Generate Captions & Descriptions: Expand image metadata beyond alt text and titles. Automate descriptive captions and detailed content descriptions with custom prompts.
Direct API Gateways (OpenAI & Gemini): Connect directly to OpenAI (ChatGPT) and Google Gemini direct APIs using your own keys to bypass third-party platforms.
Granular Overwrite Protection: Enable “Do Not Overwrite Existing Details” to selectively generate and save only empty metadata fields. If all enabled fields are already filled, the image is skipped without making API calls.
WP-CLI Integration: Trigger metadata generation and background batch processing directly from the server command line.
Save Generation Metadata: Save timestamps and execution source indicators in database.

Why You Should Upgrade to Pro

Save Hours of Manual Work: Upload and automate everything. Your site will automatically generate search-engine optimized alt texts, titles, captions, and descriptions in the background.
Better SEO & Accessibility: Captions and descriptions add deep, keyword-rich context to your image pages and attachments, boosting search visibility and accessibility compliance.
Complete Gateway Autonomy: Choose direct endpoints to utilize your custom account credits and direct API models like gpt-4o-mini and gemini-2.5-flash.

External Services

This plugin relies on OpenRouter as a third-party service to provide Artificial Intelligence capabilities.

Service Name: OpenRouter

Service URL: https://openrouter.ai/

Data Sent: Image URLs, Post Titles, and Post Content (context) are sent to the OpenRouter API when an administrator generates metadata manually in the Media Library or automatically during scheduled background batch processing (WP-Cron).

Terms of Service: OpenRouter Terms https://openrouter.ai/terms

Privacy Policy: OpenRouter Privacy Policy https://openrouter.ai/privacy

Note: You must obtain your own API key from OpenRouter to use this service.

Configuration

1. API Configuration

API Gateway: Select your AI provider (OpenRouter).
API Keys: Provide the API key for your chosen gateway.
Model Selection: Choose the model you wish to use from the dynamic dropdown menu (default: google/gemini-2.5-flash-lite).

2. Generation Options

Global Context: Instructions sent with every request. Great for setting the “persona” of the AI.
Supported Image Formats: Define which file extensions the plugin should process.
Enable Fields: Toggle which metadata fields you want to generate (Alt Text, Title).
Prompts: Customize the specific instructions for generating Alt Text or Titles. Includes “Reset to Default” buttons.

3. Bulk Generation (Cron)

Enable Background Processing: Turns on the automatic generator.
Batch Size: How many images to process per run. Recommended 1-3 to prevent server timeouts.
Interval: How often the job runs (in minutes).

Screenshots

Installation

Upload the plugin folder to the /wp-content/plugins/ directory.
Activate the plugin through the ‘Plugins’ menu in WordPress.
Navigate to Settings > AI Alt Text to configure the plugin.

FAQ

What AI models are supported by OpenRouter?

OpenRouter supports a vast array of models from all major providers. As of the latest update, supported model families include (but are not limited to):

Google: Gemini, PaLM

OpenAI: GPT (GPT-3.5, GPT-4, GPT-4o, etc.)

Anthropic: Claude (Haiku, Sonnet, Opus)

Meta: Llama

Mistral AI: Mistral, Mixtral, Codestral

DeepSeek: DeepSeek Chat/Coder

Qwen: Qwen (Alibaba)

Microsoft: WizardLM, Phi

Perplexity: Perplexity Online/Chat

X.ai: Grok

Cohere: Command

Nvidia: Nemotron

Amazon: Nova, Bedrock

Databricks: DBRX

Nous Research: Hermes

Liquid: Liquid

Arcee AI: Arcee

Moonshot AI: Kimi

Z.ai: GLM

MiniMax: MiniMax

You can find the specific Model IDs for these families on the OpenRouter Models page.

Does this plugin modify my actual image files?

No. It only updates the metadata (Alt Text and Title) in the WordPress database. Your physical image files remain untouched.

Will it overwrite my existing Alt Text?

Bulk Generation (Background): No. The background process automatically skips any image that has already been successfully processed by the plugin to save you money and preserve your data.

Manual Generation (Button): Yes. If you click the “Regenerate” button on a specific image in the Media Library, it will overwrite the existing text with the new AI result.

What happens if I uninstall the plugin?

If you delete the plugin via the Plugins screen:
It will clean up its own settings and temporary statistics.
It will remove internal logs (timestamps, error logs).
Crucially: The Alt Text and Titles generated for your images will remain. They become part of your site’s standard content and are not deleted.

My bulk generation seems stuck. What do I do?

Go to Settings > AI Alt Text. Look at the “Statistics” box.
Check the “Failed” count. If images are failing, check the “Edit Media” screen of a failed image to see the error message.
Use the “Retry Failed Images” button to move them back to the pending queue.
Use the “Reset Cron Progress” button if you want to completely restart the analysis from scratch (this allows the plugin to look at all images again).

Can I generate Alt Text or Titles for free?

Yes. Choose a free model from OpenRouter to generate metadata without any cost.

Reviews

xfard chunyo 13, 2026

GOOD Plugin

Read all 1 review

Contributors & Developers

“KooKoo AI Alt Text Creator” is open source software. The following people have contributed to this plugin.

micromax

Translate “KooKoo AI Alt Text Creator” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.4.0

Enhance WordPress.org Guideline 5 compliance by isolating Pro gateway documentation into Pro Addon hooks.
Pass settings options array to the aialtg_skip_image_generation filter for clean external consumption.
Purge Pro-only marketing strings from core translation template.
Scope configuration documentation strictly to free features.

2.3.0

Enhance WordPress.org Guideline 5 (trialware) compliance by removing inline promotional callouts from settings form fields.
Relocate advanced automation and Pro feature tips to the Help tab documentation.
Introduce public helper function aialtg_process_image() and aialtg_process_batch action hook for clean third-party and addon decoupling.
Decouple attachment generation metadata rendering via the aialtg_attachment_meta_box_details action hook.
Decouple connection testing options via the aialtg_test_connection_options filter hook.
Correct description to accurately reflect standalone core error logging.

2.2.0

Enhance compliance with WordPress.org Guideline 5 (trialware) and Guideline 11.
Fully decouple free core from Pro Addon using extensible action and filter hooks (aialtg_loaded, aialtg_show_pro_card, aialtg_show_pro_tips, aialtg_show_pro_tab, aialtg_gateway_api_key).
Ensure API Gateway configuration is preserved and validated during settings save.
Replace commercial error notices in test connection handler with neutral validation messages.
Clean up JavaScript architecture to remove hardcoded third-party gateway references from the free bundle.

2.1.1

Add contextual Pro Tip callouts below settings with enhanced Pro counterparts.
Add uninstallation cleanup script (uninstall.php) for the Pro Addon to cleanly remove Pro options.
Modernize sidebar Upgrade to Pro card with direct tab switching to the Pro preview.

2.1.0

Add dedicated Pro Preview showcase tab for free users with feature cards and upgrade guidance.
Automatically hide the Pro preview tab when the Pro Addon is active.
Implement dynamic Pro settings injection via WordPress action hooks (aialtg_register_settings_fields).
Remove dummy inputs, disabled controls, and inline Pro badges to comply with WordPress.org Plugin Directory guidelines.
Decouple Pro post-processing logic (captions, descriptions, and metadata) from core generator via extensible filter and action hooks.
Replace artificial commercial limits on Cron scheduler settings with server timeout advisories.

2.0.2

Confirmed compatibility with WordPress 7.1.0.
Synced dynamic asset versioning to main plugin version constant.

2.0.1

Add novalidate attribute to the settings form to resolve form submission failures caused by browser-side HTML5 validation on hidden tabs.

2.0.0

Implement settings fields unification, eliminating redundant teaser callbacks.
Refactor API key gateway lookups, tag replacements, and sequentially numbered prompts loop.
Enforce exact matching version checks between core and Pro Addon.
Add uninstallation cleanup for the OpenRouter models list transient.

1.9.0

Added Direct API Gateways for OpenAI and Google Gemini (Pro).
Added dynamic model switcher and placeholder updates based on selected Gateway.
Added option to generate image Captions and Descriptions with customizable prompts (Pro).
Added instant upload hook to automatically generate details on image upload (Pro).
Added Media Library bulk actions to process multiple images at once (Pro).
Refactored skip logic to granular field-level overwrite prevention (Pro).
Added Cron batch size and interval limits for free version, unlocked in Pro.
Added “Reset to Default” action link buttons under prompt textareas.
Redesigned settings layout to use premium HSL colors, focus states, and glassmorphism.
Added AJAX Test API Connection button to instantly verify API key and model config.

1.8.3

Added premium option to skip images with existing Alt Texts during background/cron runs.
Added premium option to save generation metadata (timestamp/source).
Added premium WP-CLI command integration (wp kookoo-alt-text process).
Implemented Pro addon version compatibility validation checks and warning notices.

1.8.2

Removed licensing logic and made all features completely free.
Discontinued EDD Software Licensing activation/deactivation support.
Made saving of generation metadata (timestamp/source) fully unlocked for all users.

1.8.1

Consolidated duplicated AJAX event handlers in settings screen.
Removed redundant cron health watchdog hook and method.
Removed redundant cron interval filtering code.
Optimized database uninstall metadata deletion query using SQL IN operator.

1.0.0

Initial release.