{"id":328134,"date":"2026-06-21T20:44:14","date_gmt":"2026-06-21T20:44:14","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-image-rename\/"},"modified":"2026-06-21T20:28:56","modified_gmt":"2026-06-21T20:28:56","slug":"imaxio-seo-image-renamer-alt-text","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/imaxio-seo-image-renamer-alt-text\/","author":23518067,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0","stable_tag":"trunk","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Imaxio SEO Image Renamer and Alt Text","header_author":"GuilhemF","header_description":"Optimize your image SEO (Filenames and Alt texts) via AI (OpenAI or Google Gemini) directly from the WordPress media library in one click.","assets_banners_color":"90aeb9","last_updated":"2026-06-21 20:28:56","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/guilhemf.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":27,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3580961,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3580961,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3580961,"resolution":"1","location":"assets","locale":"","width":2400,"height":1602},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3580961,"resolution":"2","location":"assets","locale":"","width":2440,"height":1602},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3580961,"resolution":"3","location":"assets","locale":"","width":2440,"height":1602}},"screenshots":{"1":"The settings page where you configure your AI provider (OpenAI or Gemini), API key, and Project Scope, featuring a live API connection test.","2":"The WordPress Media Library attachment details view before optimization, showing the original file and the new \"AI Image Rename\" button.","3":"The attachment details view after the AI has successfully generated and applied the SEO-optimized filename and Alternative Text."}},"plugin_section":[],"plugin_tags":[2353,17214,17706,163,186],"plugin_category":[50,55],"plugin_contributors":[268265],"plugin_business_model":[],"class_list":["post-328134","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-alt-text","plugin_tags-filename","plugin_tags-images","plugin_tags-seo","plugin_category-media","plugin_category-seo-and-marketing","plugin_contributors-guilhemf","plugin_committers-guilhemf"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/imaxio-seo-image-renamer-alt-text\/assets\/icon-256x256.png?rev=3580961","icon_2x":"https:\/\/ps.w.org\/imaxio-seo-image-renamer-alt-text\/assets\/icon-256x256.png?rev=3580961","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/imaxio-seo-image-renamer-alt-text\/assets\/screenshot-1.png?rev=3580961","caption":"The settings page where you configure your AI provider (OpenAI or Gemini), API key, and Project Scope, featuring a live API connection test."},{"src":"https:\/\/ps.w.org\/imaxio-seo-image-renamer-alt-text\/assets\/screenshot-2.png?rev=3580961","caption":"The WordPress Media Library attachment details view before optimization, showing the original file and the new \"AI Image Rename\" button."},{"src":"https:\/\/ps.w.org\/imaxio-seo-image-renamer-alt-text\/assets\/screenshot-3.png?rev=3580961","caption":"The attachment details view after the AI has successfully generated and applied the SEO-optimized filename and Alternative Text."}],"raw_content":"<!--section=description-->\n<p><strong>Imaxio SEO Image Renamer and Alt Text<\/strong> is a lightweight, zero-bloat WordPress plugin that uses Artificial Intelligence to automatically analyze your uploaded images and generate highly relevant, SEO-optimized filenames and <code>alt<\/code> tags.<\/p>\n\n<p>Unlike bloated alternatives, there are <strong>no forced registrations, no monthly subscriptions, and no complicated setups<\/strong>. You simply bring your own API key, and pay <strong>less than $0.01 per image<\/strong> directly to the provider for what you actually use. It's just one clean PHP file doing exactly what it promises: adding a simple settings page and a magic button in your Media Library.<\/p>\n\n<p>Tired of manually thinking about SEO for every single image? Just provide a general \"Project Scope\" to the AI, and let it do the heavy lifting.<\/p>\n\n<h3>\ud83d\ude80 Key Features<\/h3>\n\n<ul>\n<li><strong>Bring Your Own Key (BYOK):<\/strong> Seamlessly connect your own API keys for either Google Gemini or OpenAI (ChatGPT). No middleman.<\/li>\n<li><strong>Context-Aware AI:<\/strong> Provide a global \"Project Scope\" in the settings (e.g., \"High-end perfume online store\") so the AI generates tags and filenames tailored exactly to your niche and target audience.<\/li>\n<li><strong>1-Click Execution:<\/strong> No confirmation modals, no friction. Click the blue button in the media library, and the physical file is renamed instantly.<\/li>\n<li><strong>Dynamic Model Selection:<\/strong> Automatically detects and selects the fastest, and most cost-effective models available (like <code>gpt-4o-mini<\/code> or <code>gemini-2.5-flash<\/code>).<\/li>\n<li><strong>Safe File Renaming:<\/strong> Includes a failsafe duplication check. If a file with the generated filename already exists, the plugin appends a timestamp to prevent overwriting.<\/li>\n<\/ul>\n\n<h3>\u2699\ufe0f How it works<\/h3>\n\n<p>The plugin encodes your physical image file into Base64 and sends it securely to the chosen AI provider. The AI is prompted to return a strictly formatted JSON containing a descriptive, hyphen-separated filename and an SEO alt text limited to 100 characters. The plugin then updates the WordPress database and physically renames the base file on your server.<\/p>\n\n<p><em>(Note: To keep the plugin fast and avoid breaking existing content, it only renames the main physical file, not the generated thumbnails. It is highly recommended to use this plugin right after uploading an image, before inserting it into a post).<\/em><\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin relies on third-party AI services to analyze images and generate SEO-optimized filenames and alt texts. Images are converted to Base64 and sent to the chosen provider only when the user clicks the \"AI Image Rename\" button in the Media Library.<\/p>\n\n<h4>Google Gemini<\/h4>\n\n<p>Used to analyze images and generate SEO metadata.\nData sent: Base64-encoded image data and a text prompt.\nWhen: Only upon manual user action in the Media Library.\n- Terms of Service: https:\/\/ai.google.dev\/terms\n- Privacy Policy: https:\/\/policies.google.com\/privacy<\/p>\n\n<h4>OpenAI (ChatGPT)<\/h4>\n\n<p>Used to analyze images and generate SEO metadata.\nData sent: Base64-encoded image data and a text prompt.\nWhen: Only upon manual user action in the Media Library.\n- Terms of Service: https:\/\/openai.com\/policies\/terms-of-use\n- Privacy Policy: https:\/\/openai.com\/policies\/privacy-policy<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>ai-image-rename<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Navigate to <strong>Settings &gt; Imaxio Image SEO<\/strong>.<\/li>\n<li>Select your AI Provider (Google Gemini or OpenAI) and enter your API Key.<\/li>\n<li>Provide a short <strong>Project Scope<\/strong> to guide the AI.<\/li>\n<li>Click <strong>Save Settings<\/strong>, then <strong>Test API Connection<\/strong>.<\/li>\n<li>Go to your Media Library and click the new \"AI Image Rename\" button on any image!<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20this%20plugin%20free%3F\"><h3>Is this plugin free?<\/h3><\/dt>\n<dd><p>The plugin itself is 100% free and open-source. However, you will need to provide your own API key from OpenAI or Google Gemini. These AI providers charge <strong>less than $0.01 per image<\/strong> processed.<\/p><\/dd>\n<dt id=\"why%20does%20the%20gemini%20test%20fail%20with%20%22quota%20exceeded%20%28limit%3A%200%29%22%3F\"><h3>Why does the Gemini test fail with \"Quota exceeded (limit: 0)\"?<\/h3><\/dt>\n<dd><p>If your server is located in the EU, Google's free tier for the Gemini API might be restricted due to local regulations. You simply need to link a billing account in Google AI Studio to use the \"Pay-as-you-go\" tier (which remains incredibly cheap).<\/p><\/dd>\n<dt id=\"does%20it%20rename%20images%20already%20inserted%20in%20posts%3F\"><h3>Does it rename images already inserted in posts?<\/h3><\/dt>\n<dd><p>The plugin renames the physical file and updates the database. However, if the image is already embedded in a published post, the HTML link inside that post might break. It is strongly advised to rename your images in the Media Library <em>before<\/em> inserting them into your content.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Optimize your image SEO (Filenames and Alt texts) via AI (OpenAI or Google Gemini) directly from the WordPress media library in one click.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/328134","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=328134"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/guilhemf"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=328134"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=328134"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=328134"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=328134"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=328134"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=328134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}