Images without alt text are invisible to screen reader users and to image search. AmazImg writes short, descriptive alt text for them with the vision model of the AI provider you connected in WordPress (OpenAI, Anthropic Claude or Google Gemini).<\/p>\n\n
No credits, no middleman.<\/strong> Most alt text plugins sell credits and send your images through their own servers. AmazImg is built on the WordPress AI Client (WordPress 7.0+), so requests go straight from your site to your own provider, and you pay that provider's normal rates with nothing added on top.<\/p>\n\n See it in action (~3 minutes):<\/strong><\/p>\n\n https:\/\/www.youtube.com\/watch?v=acEMRWrw7CI<\/p>\n\n What the free plugin does<\/strong><\/p>\n\n Good alt text helps you meet WCAG and the European Accessibility Act, but AI is a first draft: review the text for images where the details matter.<\/p>\n\n AmazImg Pro<\/strong><\/p>\n\n The free plugin does one image at a time. AmazImg Pro<\/a> is for whole libraries and busy sites:<\/p>\n\n The first 100 customers get 50% off<\/strong> with the code FIRST100<\/strong>.<\/p>\n\n This plugin does not contact any AI service itself. It uses the WordPress AI Client (built into WordPress 7.0+), which sends requests to the AI provider the site owner connected in For each generation the image (a resized copy when available), a text prompt and short context (file name, image title, title of the page the image is attached to) are sent to the connected provider, for example:<\/p>\n\n AmazImg news (optional, off by default).<\/strong> If an administrator turns on \"News and tips\" in Media \u2192 AI Alt Text \u2192 Settings, the plugin downloads a short list of messages from AmazImg can be extended with PHP hooks and a small JavaScript API. The Pro add-on also adds a REST API and WP-CLI commands.<\/p>\n\n Add brand guidance to every prompt:<\/p>\n\n Skip images uploaded to a \"logos\" folder:<\/p>\n\n Log every generated alt text:<\/p>\n\n In the admin, The Pro add-on adds routes under When the monthly spending cap is reached, Rate limits and provider outages are retried automatically, up to 3 times, 30 seconds apart. Run In Settings \u2192 Connectors<\/strong> (WordPress 7.0+). The plugin never stores API keys; it uses the WordPress AI Client, so every AI feature on your site shares the same connection. Keys can also come from the WordPress picks a connected model that can read images. To choose, enter one or more model ids under Media \u2192 AI Alt Text \u2192 Settings \u2192 Preferred models<\/strong>.<\/p><\/dd>\n The plugin is free. You pay your AI provider directly. With the default small models, a single image typically costs a fraction of a cent.<\/p><\/dd>\n Only when you click \"Regenerate\" on an image that already has alt text.<\/p><\/dd>\n JPEG, PNG, GIF and WebP.<\/p><\/dd>\n Yes. If the file is not on the server, the plugin downloads the \"large\" size from its public URL.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
\n
External services<\/h3>\n\n
Settings \u2192 Connectors<\/code>. Nothing is sent until a provider is connected and you generate alt text, either by clicking a \"Generate\" button or through a Pro automation you turn on.<\/p>\n\n\n
https:\/\/amazimg.pro\/wp-json\/amazimg\/v1\/notices<\/code> at most about twice a day, when that screen is opened. The request sends only the plugin version; like any web request, it also reveals the site's IP address to the server. Nothing is requested while the option is off. Terms of service<\/a>, Privacy policy<\/a><\/p>\n\n\n\n
\/wp-content\/plugins\/amazimg-image-description-generator<\/code>.<\/li>\nDevelopers<\/h4>\n\n
Filters<\/h4>\n\n
\n
aatg_generate_args<\/code> ( $args, $attachment_id ): change the generation arguments.<\/li>\naatg_pre_generate<\/code> ( null, $attachment_id, $args ): return a WP_Error<\/code> to stop generation for an image.<\/li>\naatg_context<\/code> ( $context, $attachment_id ): add context to the prompt, such as a post title or product name.<\/li>\naatg_language<\/code> ( $language, $attachment_id ): choose the output language per image.<\/li>\naatg_prompt<\/code> ( $prompt, $attachment_id, $context ): change the prompt sent to the AI.<\/li>\naatg_ai_prompt_builder<\/code> ( $builder, $image, $prompt ): adjust the WordPress AI Client request before it is sent.<\/li>\naatg_max_tokens<\/code> ( $max_tokens ): change the output limit (default 1024).<\/li>\naatg_image_sizes<\/code> ( $sizes ): choose which image size is sent to the AI.<\/li>\naatg_parse_response<\/code> ( null, $raw, $attachment_id ): parse a structured reply. Return an array with an alt<\/code> key.<\/li>\naatg_is_decorative<\/code> ( false, $attachment_id ): mark an image as decorative (empty alt text).<\/li>\naatg_query_args<\/code> ( $query_args, $purpose, $args ): change which images are found.<\/li>\n<\/ul>\n\nActions<\/h4>\n\n
\n
aatg_before_save<\/code> ( $attachment_id, $result, $args ): runs just before alt text is saved.<\/li>\naatg_generated<\/code> ( $attachment_id, $result, $context, $args ): runs after a successful generation.<\/li>\naatg_generate_failed<\/code> ( $attachment_id, $error, $args ): runs after a failed generation.<\/li>\naatg_usage<\/code> ( $provider, $model, $input_tokens, $output_tokens ): reports the AI usage of each request.<\/li>\n<\/ul>\n\nError codes<\/h4>\n\n
\n
aatg_http_429<\/code>: the AI provider is rate-limiting requests. Retry later.<\/li>\naatg_http_5xx<\/code> (for example aatg_http_503<\/code>): the AI provider is temporarily unavailable. Retry later.<\/li>\naatg_http_error<\/code>: network error reaching the AI provider. Retry later.<\/li>\naatg_ai_error<\/code>: any other AI request failure, for example an invalid API key. Don't retry.<\/li>\naatg_no_key<\/code>: no AI provider is connected in Settings \u2192 Connectors.<\/li>\naatg_unsupported<\/code>: the file type is not supported. Use JPEG, PNG, GIF or WebP.<\/li>\n<\/ul>\n\nExamples<\/h4>\n\n
add_filter( 'aatg_prompt', function ( $prompt, $attachment_id, $context ) {\n return $prompt . \"\\nMention the brand name if a logo is visible.\";\n}, 10, 3 );\n<\/code><\/pre>\n\nadd_filter( 'aatg_pre_generate', function ( $error, $attachment_id ) {\n if ( false !== strpos( (string) get_attached_file( $attachment_id ), '\/logos\/' ) ) {\n return new WP_Error( 'my_skip', 'Logos are handled manually.' );\n }\n return $error;\n}, 10, 2 );\n<\/code><\/pre>\n\nadd_action( 'aatg_generated', function ( $attachment_id, $result ) {\n error_log( sprintf( 'Alt text for #%d: %s', $attachment_id, $result['alt'] ) );\n}, 10, 2 );\n<\/code><\/pre>\n\nJavaScript<\/h4>\n\n
AATG.generate( attachmentId, options )<\/code> returns a jQuery promise, and the aatg:generated<\/code> event fires after each success:<\/p>\n\nAATG.generate( attachmentId, { source: 'my-plugin' } )\n .done( function ( data ) { console.log( data.alt ); } );\n\njQuery( document ).on( 'aatg:generated', function ( event, attachmentId, data ) {\n \/\/ data.pending is set when the result was held for review.\n} );\n<\/code><\/pre>\n\nREST API (Pro)<\/h4>\n\n
\/wp-json\/amazimg-pro\/v1<\/code>. To call them from outside WordPress, sign in with an application password (Users \u2192 Profile \u2192 Application Passwords) using HTTP Basic auth.<\/p>\n\n\n
GET \/stats<\/code>: total images, images missing alt text, items pending review, queue size, and this month's usage and estimated cost. Needs the upload_files<\/code> capability.<\/li>\nGET \/images?status=missing|low|all&page=1&per_page=20<\/code>: lists images with their alt text, SEO score and issues, any pending suggestion, and whether undo is possible. Paging headers: X-WP-Total<\/code> and X-WP-TotalPages<\/code>. Needs upload_files<\/code>.<\/li>\nPOST \/images\/{id}\/generate<\/code>: generates alt text for one image. Parameters: overwrite<\/code> (default false), save<\/code> (default true; false returns only a suggestion) and skip_review<\/code> (default false). Needs permission to edit the image.<\/li>\nPOST \/images\/{id}\/undo<\/code>: restores the alt text from before the last AI change. Returns 409 when there is nothing to undo. Needs permission to edit the image.<\/li>\nGET \/queue<\/code>: queue size and the last error. Needs upload_files<\/code>.<\/li>\nPOST \/queue<\/code>: adds images to the background queue. Pass ids<\/code> (an array of attachment IDs) or scope<\/code> (missing<\/code>, low<\/code> or all<\/code>), plus overwrite<\/code>. Needs upload_files<\/code>.<\/li>\n<\/ul>\n\ngenerate<\/code> returns HTTP 429 with the code aatgp_budget<\/code>.<\/p>\n\ncurl -u 'admin:xxxx xxxx xxxx xxxx' -X POST \\\n 'https:\/\/example.com\/wp-json\/amazimg-pro\/v1\/images\/123\/generate?save=false'\n<\/code><\/pre>\n\nWP-CLI (Pro)<\/h4>\n\n
wp amazimg generate --limit=500\nwp amazimg generate 12 34 --overwrite\nwp amazimg generate --scope=low --products --skip-review\nwp amazimg generate --queue\nwp amazimg generate --dry-run\nwp amazimg undo 12 34\nwp amazimg undo --run=<run-id>\nwp amazimg review list|approve|reject [<id>...]\nwp amazimg sync-content [--replace] [--dry-run]\nwp amazimg stats --format=json\nwp amazimg queue status|run|clear\n<\/code><\/pre>\n\nwp help amazimg<\/code> for the full reference.<\/p>\n\n\n\n
Where do I enter my API key?<\/h3><\/dt>\n
OPENAI_API_KEY<\/code>, ANTHROPIC_API_KEY<\/code> or GOOGLE_API_KEY<\/code> constants or environment variables.<\/p><\/dd>\nWhich model is used?<\/h3><\/dt>\n
How much does it cost?<\/h3><\/dt>\n
Does it overwrite my existing alt text?<\/h3><\/dt>\n
Which image formats are supported?<\/h3><\/dt>\n
My images are on a CDN \/ S3. Does it work?<\/h3><\/dt>\n
1.0.5<\/h4>\n\n
\n
1.0.4<\/h4>\n\n
\n
1.0.3<\/h4>\n\n
\n
1.0.2<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n