Title: Imaxio SEO Image Renamer and Alt Text
Author: guilhemf
Published: <strong>June 21, 2026</strong>
Last modified: June 21, 2026

---

Search plugins

![](https://ps.w.org/imaxio-seo-image-renamer-alt-text/assets/icon-256x256.png?rev
=3580961)

# Imaxio SEO Image Renamer and Alt Text

 By [guilhemf](https://profiles.wordpress.org/guilhemf/)

[Download](https://downloads.wordpress.org/plugin/imaxio-seo-image-renamer-alt-text.zip)

 * [Details](https://wordpress.org/plugins/imaxio-seo-image-renamer-alt-text/#description)
 * [Reviews](https://wordpress.org/plugins/imaxio-seo-image-renamer-alt-text/#reviews)
 *  [Installation](https://wordpress.org/plugins/imaxio-seo-image-renamer-alt-text/#installation)
 * [Development](https://wordpress.org/plugins/imaxio-seo-image-renamer-alt-text/#developers)

 [Support](https://wordpress.org/support/plugin/imaxio-seo-image-renamer-alt-text/)

## Description

**Imaxio SEO Image Renamer and Alt Text** 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 `alt` tags.

Unlike bloated alternatives, there are **no forced registrations, no monthly subscriptions,
and no complicated setups**. You simply bring your own API key, and pay **less than
$0.01 per image** 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.

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.

### 🚀 Key Features

 * **Bring Your Own Key (BYOK):** Seamlessly connect your own API keys for either
   Google Gemini or OpenAI (ChatGPT). No middleman.
 * **Context-Aware AI:** 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.
 * **1-Click Execution:** No confirmation modals, no friction. Click the blue button
   in the media library, and the physical file is renamed instantly.
 * **Dynamic Model Selection:** Automatically detects and selects the fastest, and
   most cost-effective models available (like `gpt-4o-mini` or `gemini-2.5-flash`).
 * **Safe File Renaming:** Includes a failsafe duplication check. If a file with
   the generated filename already exists, the plugin appends a timestamp to prevent
   overwriting.

### ⚙️ How it works

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.

_(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)._

### External Services

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.

#### Google Gemini

Used to analyze images and generate SEO metadata.
 Data sent: Base64-encoded image
data and a text prompt. When: Only upon manual user action in the Media Library.–
Terms of Service: https://ai.google.dev/terms – Privacy Policy: https://policies.
google.com/privacy

#### OpenAI (ChatGPT)

Used to analyze images and generate SEO metadata.
 Data sent: Base64-encoded image
data and a text prompt. When: Only upon manual user action in the Media Library.–
Terms of Service: https://openai.com/policies/terms-of-use – Privacy Policy: https://
openai.com/policies/privacy-policy

## Screenshots

[⌊The settings page where you configure your AI provider (OpenAI or Gemini), API
key, and Project Scope, featuring a live API connection test.⌉⌊The settings page
where you configure your AI provider (OpenAI or Gemini), API key, and Project Scope,
featuring a live API connection test.⌉[

The settings page where you configure your AI provider (OpenAI or Gemini), API key,
and Project Scope, featuring a live API connection test.

[⌊The WordPress Media Library attachment details view before optimization, showing
the original file and the new "AI Image Rename" button.⌉⌊The WordPress Media Library
attachment details view before optimization, showing the original file and the new"
AI Image Rename" button.⌉[

The WordPress Media Library attachment details view before optimization, showing
the original file and the new “AI Image Rename” button.

[⌊The attachment details view after the AI has successfully generated and applied
the SEO-optimized filename and Alternative Text.⌉⌊The attachment details view after
the AI has successfully generated and applied the SEO-optimized filename and Alternative
Text.⌉[

The attachment details view after the AI has successfully generated and applied 
the SEO-optimized filename and Alternative Text.

## Installation

 1. Upload the `ai-image-rename` folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.
 3. Navigate to **Settings > Imaxio Image SEO**.
 4. Select your AI Provider (Google Gemini or OpenAI) and enter your API Key.
 5. Provide a short **Project Scope** to guide the AI.
 6. Click **Save Settings**, then **Test API Connection**.
 7. Go to your Media Library and click the new “AI Image Rename” button on any image!

## FAQ

### Is this plugin free?

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 **less 
than $0.01 per image** processed.

### Why does the Gemini test fail with “Quota exceeded (limit: 0)”?

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).

### Does it rename images already inserted in posts?

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 _before_ inserting
them into your content.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Imaxio SEO Image Renamer and Alt Text” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ guilhemf ](https://profiles.wordpress.org/guilhemf/)

[Translate “Imaxio SEO Image Renamer and Alt Text” into your language.](https://translate.wordpress.org/projects/wp-plugins/imaxio-seo-image-renamer-alt-text)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/imaxio-seo-image-renamer-alt-text/),
check out the [SVN repository](https://plugins.svn.wordpress.org/imaxio-seo-image-renamer-alt-text/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/imaxio-seo-image-renamer-alt-text/)
by [RSS](https://plugins.trac.wordpress.org/log/imaxio-seo-image-renamer-alt-text/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0

 * Initial release.

## Meta

 *  Version **1.0**
 *  Last updated **15 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [AI](https://wordpress.org/plugins/tags/ai/)[Alt Text](https://wordpress.org/plugins/tags/alt-text/)
   [filename](https://wordpress.org/plugins/tags/filename/)[images](https://wordpress.org/plugins/tags/images/)
   [seo](https://wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://wordpress.org/plugins/imaxio-seo-image-renamer-alt-text/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/imaxio-seo-image-renamer-alt-text/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/imaxio-seo-image-renamer-alt-text/reviews/)

## Contributors

 *   [ guilhemf ](https://profiles.wordpress.org/guilhemf/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/imaxio-seo-image-renamer-alt-text/)