Title: ImgSEO – AI Image Alt Text Generator & Image SEO Tools Author: pianoweb Published: December 23, 2024 Last modified: June 3, 2026 --- Search plugins ![](https://ps.w.org/imgseo-ai-alt-text-generator/assets/banner-772x250.png?rev= 3305785) ![](https://ps.w.org/imgseo-ai-alt-text-generator/assets/icon-256x256.png?rev=3214700) # ImgSEO – AI Image Alt Text Generator & Image SEO Tools By [pianoweb](https://profiles.wordpress.org/pianoweb/) [Download](https://downloads.wordpress.org/plugin/imgseo-ai-alt-text-generator.2.7.2.zip) * [Details](https://wordpress.org/plugins/imgseo-ai-alt-text-generator/#description) * [Reviews](https://wordpress.org/plugins/imgseo-ai-alt-text-generator/#reviews) * [Installation](https://wordpress.org/plugins/imgseo-ai-alt-text-generator/#installation) * [Development](https://wordpress.org/plugins/imgseo-ai-alt-text-generator/#developers) [Support](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/) ## Description **ImgSEO** automates complete alt text and metadata optimization for WordPress. Unlike basic AI tools that only analyze images, ImgSEO combines **advanced computer vision with intelligent page context analysis** to generate truly accurate and relevant metadata. #### What Makes ImgSEO Different? **🧠 Context-Aware Intelligence** ImgSEO doesn’t just “see” your images—it understands them in context by analyzing: * Page title, headings, and surrounding content * Existing filenames and metadata * WooCommerce product data (for e-commerce sites)* Custom AI prompts with brand keywords This context awareness produces descriptions that actually match your content, not generic AI guesses. **⚡ Ultra-Fast Bulk Processing** * Process **1000+ images in minutes** with parallel processing * Up to **16x faster** than sequential methods (configurable speed modes)* Handle massive libraries without memory issues (paginated 100 images/batch) * Background processing with pause/resume capability **📦 Complete Automation** * **Alt text, title, caption & description** – All metadata from one generation * **Smart file renaming** – DSC_0001.jpg summer-collection- red-dress.jpg with automatic reference updates * **JSON-LD Schema Markup** – Complete Schema.org ImageObject implementation with 5 levels of fields (core, SEO essentials, attribution, context, technical metadata) including EXIF data, geolocation, publisher info, and smart hash-based caching * **XML Image Sitemaps** – Automated generation with scheduled updates (hourly/daily/weekly) **🚀 Performance Optimized** Version 2.2 includes major optimizations specifically for large sites: * 73% reduction in database queries (from ~150 to ~40 per page)* 50-60% less memory usage in bulk operations * Smart thumbnail fallback for images >3MB (70-90% bandwidth reduction) * Automatic base64 fallback for CDN/hotlink-protected sites **⚖️ Legal Compliance Made Easy** With the European Accessibility Act (EAA) becoming mandatory on **June 28, 2025**, proper image alt text is no longer optional—**it’s the law**. ImgSEO helps you meet WCAG 2.1 AA, EAA, ADA, and Section 508 standards while simultaneously boosting your search rankings. #### Key Benefits * **Double Your SEO Impact**: Properly described images rank better in both regular and image search results * **Ensure Legal Compliance**: Meet WCAG 2.1 AA, EAA, ADA, Section 508 and other global accessibility standards * **Save Hours of Manual Work**: Process your entire media library with one click * **Improve User Experience**: Help screen readers accurately describe images to visually impaired visitors * **Enhance E-commerce Performance**: Better product image descriptions improve conversion rates * **Boost Search Indexing**: XML sitemaps and JSON-LD markup help search engines discover and understand your images * **Rich Search Results**: Schema markup enables enhanced search snippets with image metadata #### Who Should Use ImgSEO? **Perfect for:** * **E-commerce Stores** – Product images need accurate descriptions for both SEO and accessibility compliance * **Photography & Portfolio Sites** – Transform large image galleries into SEO assets * **News & Magazine Sites** – Process hundreds of images daily with automated workflows * **Marketing Agencies** – Manage multiple client sites from one dashboard with team accounts * **Corporate Websites**– Meet accessibility compliance requirements (EAA, ADA, WCAG 2.1 AA) * **Bloggers & Content Creators** – Save hours of manual alt text writing * **Sites with Legacy Images** – Fix thousands of images missing alt text with bulk processing #### Core AI Features * **Intelligent Context Analysis** – Analyzes page title, content, and filename for contextually relevant descriptions * **WooCommerce Optimization** – Specialized AI prompts for product images that boost conversion rates * **Multilingual Support** – Generate alt text in 25+ languages (English, Italian, Spanish, German, French, Portuguese, Japanese, Arabic, and more) * **Custom AI Prompts** – Inject brand keywords and control output style for consistent brand voice * **Automatic Generation** – Real-time alt text creation as you upload new images * **Complete Metadata Update** – Auto-populate title, description, alt text, and caption fields from one AI generation #### Bulk Operations & Automation * **High-Performance Bulk Processing** – Process up to 16 images in parallel with configurable speed modes (Safe, Normal, Fast, Ultra, Insane) * **Smart Job Management** – Background processing with progress tracking, pause/ resume, and automatic recovery * **Paginated Operations** – Process 100 images per batch to prevent memory exhaustion on large libraries * **Individual Processing** – Generate or update alt text for specific images directly from Media Library #### File Renaming System * **Dual Rename Methods** – AI-powered intelligent names or pattern-based templates with dynamic variables * **Bulk Rename** – Rename hundreds of images with parallel processing (up to 16x faster than sequential) * **Automatic Reference Updates** – Updates all post/page references automatically when renaming files * **Backup & Restore** – Complete rename history with one-click restore capability * **Thumbnail Handling** – Automatically renames all image sizes and thumbnails * **Safety System** – Multi-layer confirmation with preview before execution #### SEO & Search Discovery * **JSON-LD Schema Markup** – Complete Schema.org ImageObject with 5 levels of fields (core, SEO essentials, attribution, context, technical metadata) including EXIF data, GPS geolocation, publisher organization, and smart hash-based caching for optimal performance * **XML Image Sitemaps** – Automated generation with scheduled auto-refresh (hourly/ daily/weekly) * **Sitemap Notifications** – Smart alerts when sitemap needs updating after new image additions * **Character Limit Control** – Set max alt text length (recommended ~125 characters for SEO) #### Performance & Reliability * **Database Optimization** – Reduced queries from ~150 to ~40 per page load (73% reduction) * **Memory Efficiency** – 50-60% less memory usage in bulk operations * **Thumbnail Fallback** – Images >3MB automatically use WordPress thumbnails ( 70-90% bandwidth reduction) * **CDN & Hotlink Protection** – Automatic base64 fallback for sites with anti- hotlinking or Cloudflare protection * **Query Caching** – Expensive COUNT queries cached with 5-minute transients * **Conditional Loading** – Hooks only loaded when features are enabled #### Advanced Features * **Cloud Dashboard** – Track usage, manage tokens, export reports at [dashboard.imgseo.net](https://dashboard.imgseo.net) * **Team Collaboration** – Multiple user accounts and API token management for agencies * **Field Selection Control** – Choose which metadata fields to update (title, alt text, caption, description) * **Timeout Settings** – Control API response time limits for your server configuration * **Page Builder Compatible** – Works with Elementor, Divi, WPBakery, Gutenberg( beta) * **Browser Extension** – Access ImgSEO features outside of WordPress (available separately) * **Developer Hooks** – Extensive filter and action hooks for custom integrations #### Central Cloud Dashboard At [dashboard.imgseo.net](https://dashboard.imgseo.net) you can: * Monitor available credits and usage statistics * Purchase one-time credit packs or subscribe to a plan * Manage API tokens for multiple sites or environments * Review and export the complete history of generated alt texts * Add team members with controlled access _Register free at_ [dashboard.imgseo.net/register](https://dashboard.imgseo.net/register)– get **30 credits** instantly **+ 10 new credits every day** whenever your balance drops below 10. #### Accessibility & Legal Compliance ImgSEO helps address: * **WCAG 2.1 / ISO 40500** – Success Criterion 1.1.1 _Non-text Content_ * **European Accessibility Act (Directive 2019/882)** – Mandatory from **June 28, 2025** * **ADA Title II (USA 2024 DOJ Final Rule)** & **Section 508 Refresh** * **AODA & Accessible Canada Act**, **UK PSBAR 2018**, **BITV 2.0 (DE)**, **RGAA 4.1 (FR)** * **JIS X 8341-3 (JP)**, **GB/T 37668-2019 (CN)**, **e-MAG 3.0 (BR)** > _Best practice built-in:_ ImgSEO limits alt text to ~125 characters, avoids redundant > phrases like “image of…”, and lets you mark decorative images appropriately. #### Pricing | Pack | Credits | Price | Cost/credit | |——|———|——-|————-| | Pro | 1 000 | € 9.90 | € 0.0099 | | Elite | 5 000 | € 39.90 | € 0.0080 | | Ultra | 20 000 | € 99.00 | € 0.0050 | | Unlimited | 200 000 | € 499.90 | € 0.0025 | _Free tier:_ 30 starter credits + daily refill up to 10. One-time credit packs available– see [imgseo.net/#prices](https://imgseo.net/#prices). ### External Services This plugin connects to **ImgSEO AI API** to analyse the submitted image (URL or binary) and produce alt text or a suggested filename. No personal data beyond the image itself is transmitted. Full terms: [https://imgseo.net/terms-of-service/](https://imgseo.net/terms-of-service/) ### Accessibility Statement Our goal is to make ImgSEO usable by everyone. The plugin’s admin screens follow WordPress core accessibility guidelines, and we test each release with screen readers and keyboard navigation. Please report issues via our support forum so we can improve further. ## Screenshots [⌊Main Settings Page - Configure API key, language, automatic generation, and metadata options⌉⌊Main Settings Page - Configure API key, language, automatic generation, and metadata options⌉[ **Main Settings Page** – Configure API key, language, automatic generation, and metadata options [⌊Bulk Operations - Process hundreds of images with parallel processing and real- time progress tracking⌉⌊Bulk Operations - Process hundreds of images with parallel processing and real-time progress tracking⌉[ **Bulk Operations** – Process hundreds of images with parallel processing and real- time progress tracking [⌊Media Library Integration - Generate alt text directly from the Media Library for individual images⌉⌊Media Library Integration - Generate alt text directly from the Media Library for individual images⌉[ **Media Library Integration** – Generate alt text directly from the Media Library for individual images [⌊File Renaming System - AI-powered or pattern-based bulk rename with preview and backup⌉⌊File Renaming System - AI-powered or pattern-based bulk rename with preview and backup⌉[ **File Renaming System** – AI-powered or pattern-based bulk rename with preview and backup [⌊Cloud Dashboard - Track usage, manage credits, and export detailed reports⌉⌊Cloud Dashboard - Track usage, manage credits, and export detailed reports⌉[ **Cloud Dashboard** – Track usage, manage credits, and export detailed reports [⌊XML Sitemap Management - Automated sitemap generation with scheduled updates⌉⌊ XML Sitemap Management - Automated sitemap generation with scheduled updates⌉[ **XML Sitemap Management** – Automated sitemap generation with scheduled updates [⌊JSON-LD Schema Settings - Configure structured data for enhanced search visibility⌉⌊ JSON-LD Schema Settings - Configure structured data for enhanced search visibility⌉[ **JSON-LD Schema Settings** – Configure structured data for enhanced search visibility ## Installation 1. Upload the plugin folder to `/wp-content/plugins/imgseo` or install via _Plugins Add New_ 2. Activate **ImgSEO** 3. Register at [dashboard.imgseo.net/register](https://dashboard.imgseo.net/register) and copy your API key 4. In _Settings ImgSEO_, paste the key, choose your language and options 5. Upload a new image or run the bulk optimizer – done! ## FAQ ### Do I need an API key? Yes. Registration is free and supplies 30 initial credits. ### Which languages are supported? More than 25, including English, Italian, Spanish, German, French, Portuguese, Japanese and Arabic. ### Can I track what the AI generated? Yes – the dashboard stores a per-image log with search and export. ### How are credits consumed? 1 credit = 1 alt text **or** 1 filename. ### How does the daily refill work? If your balance is below 10 at **00:00 server time**, we top you back up to 10. ### Can I exclude decorative images? NEXT UPGRADE: Sure – will mark decorative images or will set `alt=""` and ImgSEO will skip them. ### Is AI output editable? Always. You can tweak or overwrite the generated alt text in WordPress. ### How does the AI determine what’s in the image? ImgSEO uses advanced computer vision to identify objects, scenes, people, and actions in images. It combines this visual analysis with the surrounding page context (title, content) to create more relevant descriptions. ### Will this plugin slow down my site? No. The AI processing happens on our servers, not yours. The generated alt text and filenames are stored in your WordPress database just like regular metadata. ### Can I use ImgSEO with WooCommerce? Absolutely! ImgSEO works exceptionally well with e-commerce sites, where proper product image descriptions can significantly impact conversion rates and SEO. ### Does ImgSEO work with page builders? Yes, ImgSEO is compatible (this upgrade still in beta) with major page builders including Elementor, Divi, WPBakery, and Gutenberg. ### What is JSON-LD Schema Markup and why is it important? JSON-LD Schema Markup is structured data that helps search engines understand your images better. ImgSEO automatically generates complete Schema.org ImageObject markup with 5 levels of fields: core data, SEO essentials (caption, dimensions, dates), attribution (publisher, author), context relations (page context, keywords), and technical metadata (EXIF data, GPS geolocation, file hash). This comprehensive implementation can lead to enhanced search results, better indexing, and potentially rich snippets in Google Image Search. The smart caching system ensures optimal performance with hash-based change detection. ### How do XML Image Sitemaps work? ImgSEO generates XML sitemaps specifically for your images, making it easier for search engines to discover and index them. The plugin offers automatic generation with configurable refresh schedules (hourly, daily, weekly) and smart notifications when updates are needed after new image additions. ### How fast is the bulk processing? Very fast! The plugin uses parallel processing with configurable speed modes: –** Safe**: 2 parallel requests – **Normal**: 4 parallel requests – **Fast**: 6 parallel requests – **Ultra**: 12 parallel requests – **Insane**: 16 parallel requests (up to 16x faster than sequential) Processing happens in batches of 100 images to prevent memory issues on large libraries. ### Which settings apply to the Bulk Generator? The Bulk Generator uses your General Settings for **Language**, **Prompts**, and** Character Limits**. However, to ensure maximum performance, it currently **ignores**: *** Renamer Settings**: Files are not renamed during bulk alt text generation. * **Compression**: Images are not compressed during this process. * **Auto-Generate on Upload**: This setting applies only to new uploads, not existing bulk jobs. ### What happens if my site has hotlink protection or uses Cloudflare? No problem! ImgSEO automatically detects 403 Forbidden errors, CDN blocks, and anti- bot protection. When detected, it switches to base64 encoding using WordPress thumbnails. You can also force base64 mode in settings for complete compatibility. ### Can I undo file renames? Yes! Every rename operation is logged in the database with full backup information. You can restore individual images or bulk restore from the rename logs page with one click. ### Does renaming files break my posts and pages? No. The plugin automatically updates all references in posts, pages, and custom post types when renaming files. It also updates all thumbnail sizes and WordPress metadata to prevent broken images. ### How do I enable debug mode? Add `define('IMGSEO_DEBUG_MODE', true);` to your wp-config.php file. This enables detailed logging to wp-content/debug.log and JavaScript console output for troubleshooting. ### Which developer filters control generation quality? ImgSEO exposes `imgseo_should_generate_alt`, `imgseo_context_alts_limit`, `imgseo_existing_alts_for_post`, and `imgseo_final_prompt` for developers who need to customize automatic generation decisions, context size, sibling alt text context, or the final prompt sent to the API. ### Will this work with large image libraries (10,000+ images)? Yes! Version 2.1.5 includes major performance optimizations specifically for large libraries: – Paginated processing (100 images per batch) – 73% reduction in database queries – 50-60% less memory usage – Smart thumbnail fallback for images >3MB – Query result caching with transients ### Can I use this on client sites or for agencies? Absolutely! The Cloud Dashboard supports team collaboration with multiple user accounts and API token management. You can manage tokens for multiple sites from one central location. ### Does this affect my site’s loading speed? No. All AI processing happens on ImgSEO’s servers, not yours. The plugin only stores the generated text in your WordPress database like regular metadata. Version 2.1.5 actually improves performance by reducing database queries by 73%. ### What image formats are supported? The following image formats are supported for AI processing: **JPEG, PNG, WebP, AVIF, HEIC, BMP, GIF, and TIFF**. Unsupported formats like SVG and ICO are automatically skipped during bulk processing with a notification. ### Is my data secure? Yes. The plugin implements multiple security measures: – **API Key Protection**: Keys stored securely in WordPress options, never exposed in logs – **Rate Limiting**: Maximum 5 API verification attempts per 10 minutes per user – **Path Validation**: All file operations validate paths are within upload directory – **AJAX Nonce Verification**: All AJAX requests require WordPress nonce tokens – **Permission Checks**: User capability checks on all file operations – **No Personal Data**: Only image content is transmitted to ImgSEO servers, no user data The plugin passes WordPress Coding Standards (PHPCS) validation and follows WordPress security best practices. ## Reviews ![](https://secure.gravatar.com/avatar/442a600344ac189aa0af2ed348436fc1de34663a52f32e99f77f337859a2498f? s=60&d=retro&r=g) ### 󠀁[Superb Plugin](https://wordpress.org/support/topic/superb-plugin-432/)󠁿 [paintables](https://profiles.wordpress.org/paintables/) January 20, 2026 1 reply Time is precious and IMAGE SEO has saved me tons of time sitting creating descriptions and ALT names etc for my website Images I upload. Its consistent and 99.9% of the time spot on. It is AI so small checks are needed from time to time but these are minimal.Well done on a excellent plugin. ![](https://secure.gravatar.com/avatar/74e81998e0b6a0eeb8b24f47c404b8bfddbff66724a68715f7e6f02ecfdd95ee? s=60&d=retro&r=g) ### 󠀁[Responsive and friendly service](https://wordpress.org/support/topic/responsive-and-friendly-service/)󠁿 [gardeningnorm](https://profiles.wordpress.org/gardeningnorm/) September 15, 2025 1 reply I was having trouble installing the plugin on my site and tech support kindly helped me out. Thank them very much ![](https://secure.gravatar.com/avatar/732ed85fd0c13168d99d4fcbd2985744be35475a6c605a03ce30d9df6afa74be? s=60&d=retro&r=g) ### 󠀁[Impressive Image renaming solution, Even better support](https://wordpress.org/support/topic/impressive-image-renaming-solution-even-better-support/)󠁿 [Pavilionweb](https://profiles.wordpress.org/pavilionweb/) September 2, 2025 1 reply The tool works exactly as promised—fast, reliable, and easy to use. It handled my image renaming needs without a hitch. What really stood out was the support team: quick to respond, helpful, and genuinely invested in solving my issue. Great product, even better people behind it. ![](https://secure.gravatar.com/avatar/748a1341d9c5de09ff5c367536a90118381b07d839c93d85cb73e2da8cb68423? s=60&d=retro&r=g) ### 󠀁[Worth trying it!](https://wordpress.org/support/topic/worth-trying-it/)󠁿 [tomi500](https://profiles.wordpress.org/tomi500/) August 1, 2025 1 reply An excellent and multifunctional plugin, well conceived as functionality and highly customizable. I recommend! ![](https://secure.gravatar.com/avatar/6e6044c7495ac662799a7bf0ede52fd6cfda617edb75166ae2e92f40477b19b2? s=60&d=retro&r=g) ### 󠀁[Very Good Plugin](https://wordpress.org/support/topic/very-good-plugin-2974/)󠁿 [francilazze](https://profiles.wordpress.org/francilazze/) May 14, 2025 1 reply Efficient and reliable. ImgSEO bulk‑generates accurate alt text and renames image files without slowing WordPress down, making accessibility compliance much easier. The AI’s context analysis keeps descriptions relevant, and the interface is straightforward. Solid plugin, nice support! It is free for small websites. ![](https://secure.gravatar.com/avatar/c58111054872e941a6b7bd17611e1ec1198a82b9fa7bf28207d4677883d1e1ad? s=60&d=retro&r=g) ### 󠀁[The BEST plugin for SEO!](https://wordpress.org/support/topic/the-best-plugin-for-seo-25/)󠁿 [fridapepi3](https://profiles.wordpress.org/fridapepi3/) May 14, 2025 1 reply A plugin that marries certified accessibility (European Accessibility Act) with top-tier SEO performance: not only does it adhere to European standards for users with disabilities, but it also propels your site to the top of search results. This plugin is so helpful, well-constructed and smart that now I can’t even image working without it! I purchased a pack to support the plugin’s development and to receive additional credits for a better experience. I strongly recommend ImgSEO to everyone! [ Read all 10 reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/) ## Contributors & Developers “ImgSEO – AI Image Alt Text Generator & Image SEO Tools” is open source software. The following people have contributed to this plugin. Contributors * [ pianoweb ](https://profiles.wordpress.org/pianoweb/) [Translate “ImgSEO – AI Image Alt Text Generator & Image SEO Tools” into your language.](https://translate.wordpress.org/projects/wp-plugins/imgseo-ai-alt-text-generator) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/imgseo-ai-alt-text-generator/), check out the [SVN repository](https://plugins.svn.wordpress.org/imgseo-ai-alt-text-generator/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/imgseo-ai-alt-text-generator/) by [RSS](https://plugins.trac.wordpress.org/log/imgseo-ai-alt-text-generator/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.7.2 * **ENHANCED**: Updated to the latest AI model for improved generation quality #### 2.7.1 * **NEW**: Context-aware alt text variation now considers existing alt texts from sibling images in the same post, helping galleries avoid repetitive AI openings and wording * **NEW**: Added an Automatic Generation setting to disable context-aware variation if needed; it is enabled by default for better gallery quality * **NEW**: Added opt-in “first N images per post” automatic generation limits with a default-off toggle and configurable 1-100 image threshold * **ENHANCED**: Replaced the five default prompts for alt text, image title, caption, description, and WooCommerce product alt text with accessibility-first, anti- repetition instructions * **FIX**: Strengthened page-topic relevance guards so unrelated page keywords, professions, services, or SEO terms are not forced into image metadata when they are not visible in the image * **FIX**: Tightened default prompt migration and visible-content rules so saved default prompts are upgraded without overwriting custom prompts * **DEVELOPER**: Added/standardized `imgseo_should_generate_alt`, `imgseo_context_alts_limit`,` imgseo_existing_alts_for_post`, and `imgseo_final_prompt` filters for generation customization #### 2.7.0 * **NEW**: Added WooCommerce Product schema enhancement for product pages, enriching native WooCommerce Product JSON-LD with product images, gallery/variation images, brand, category, SKU, offers, availability, and aggregate rating when available * **NEW**: Product images generated as `ImageObject` now link back to the WooCommerce product via `about`, improving image-to-product context in structured data * **NEW**: Added a dedicated “Enhance WooCommerce Product Schema” option to Structured Data settings, enabled by default for new installations * **ENHANCED**: Structured Data defaults now use a Safe SEO preset on first install: caption, dimensions, dates, thumbnails, publisher, context, WooCommerce product schema, and family-friendly are enabled by default; author, featured, keywords, technical metadata, EXIF, SHA256, and GPS remain opt-in * **FIX**: Structured Data checkbox settings now save disabled states correctly by submitting explicit `0` values when unchecked * **FIX**: Auto-refresh frequency is now registered with the WordPress Settings API and saved correctly * **FIX**: Improved attachment resolution for resized image URLs such as `image- 300x200.jpg`, helping structured data use full WordPress attachment metadata instead of falling back to generic image schema * **ENHANCED**: Generic/external image schema now respects relevant structured data toggles for dimensions, encoding format, publisher, context, technical baseline, and family-friendly output #### 2.6.2 * **BUG FIX**: Default alt text prompt no longer appears empty on fresh installations— the activator was initializing `imgseo_custom_prompt` as an empty string, causing` get_option()` to return `''` instead of the built-in default; the option is now left unset on activation so the render method fallback works correctly * **BUG FIX**: Added `empty()` guard in the alt text prompt render method to also recover existing installations that already have the empty string stored in the database * **PERFORMANCE**: Removed redundant `update_meta_cache()` call in the batch processor—` get_posts()` already primes the meta cache internally, making the explicit call a no-op * **CLEANUP**: Removed stale commented-out AJAX hook in main plugin file #### 2.6.1 * **SECURITY**: Removed unnecessary `wp_ajax_nopriv` registration on `check_image_exists` endpoint — the action requires authentication and had no legitimate public use * **BUG FIX**: Implemented missing cron callback for `imgseo_check_stuck_jobs` — the hook was scheduled daily since v2.0 but the handler was never registered, leaving stuck jobs unresolved indefinitely; jobs in `pending`/`processing` state for more than 2 hours are now automatically marked as `error` * **BUG FIX**: Database cleanup operations (Clear Logs & Cache, Factory Reset, Uninstall) now correctly include the `imgseo_logs` table, which was created on activation but never cleaned up causing unbounded growth * **BUG FIX**: Factory Reset and Uninstall now delete all plugin options including` imgseo_credits`, `imgseo_plan`, `imgseo_last_check`, `imgseo_update_title/caption/ description`, `imgseo_processing_speed`, `imgseo_batch_size`, and all Structured Data v2.5 options that were previously left behind * **BUG FIX**: Uninstall now removes plugin post meta (`_imgseo_file_hash`, `_imgseo_exif_cache`,` _imgseo_sd_cache`, `_imgseo_last_sd_update`) when “Delete data on uninstall” is enabled * **BUG FIX**: Clear Logs & Cache now also truncates `imgseo_url_index` (URLattachment ID cache) which was never cleared by any cleanup operation * **PERFORMANCE**: Eliminated N+1 query pattern on Bulk Operations page — `wp_attachment_is_image()` was called once per image in a loop despite the SQL query already filtering by` post_mime_type LIKE 'image/%'`; replaced with a direct `count()` of the query result (on a 1,000-image site: from 1,001 queries to 1) * **PERFORMANCE**: Removed `wp_cache_flush()` calls from image rename operations— flushed the entire object cache (Redis/Memcached included) on every single rename;` clean_post_cache()` was already called immediately before and covers all necessary invalidation * **PERFORMANCE**: Six options (`imgseo_credits`, `imgseo_plan`, `imgseo_last_check`,` imgseo_custom_prompt`, `imgseo_footer_badge`, `imgseo_support_link`) now registered with `autoload=no` — reduces memory loaded on every page request for options only needed in admin or during generation; existing installations are migrated automatically on first load * **FIX**: Corrected `IMGSEO_PLUGIN_VERSION` constant which was still set to `2.3` despite plugin being at version `2.6` #### 2.6 * **NEW**: Complete Schema.org ImageObject implementation with 5 field levels – Core (always active), SEO Essentials (caption, dimensions, dates, thumbnails), Attribution (publisher organization, author), Context & Relations (isPartOf, mainEntityOfPage, keywords, inLanguage), Technical Metadata (contentSize, accessMode, EXIF data, SHA256 hash, GPS geolocation, family-friendly) * **PERFORMANCE**: Hash-based caching system – Technical metadata (EXIF, GPS, SHA256) calculated once and cached with automatic change detection via SHA256 file hashing * **NEW**: Checkbox-based settings with dependencies – 15+ granular controls for structured data fields with JavaScript-enforced dependencies (e.g., publisher name/URL only enabled when publisher checkbox active) * **ENHANCED**: Smart output logic – Fields only appear in JSON if they have valid data (no empty or null values) for cleaner Schema.org validation * **NEW**: EXIF data extraction – Camera model, focal length, ISO, aperture, shutter speed, and software automatically extracted from image metadata * **NEW**: GPS geolocation support – ContentLocation with GeoCoordinates automatically populated when EXIF GPS data available * **NEW**: Publisher organization – Configurable publisher with @type, @id, name, and URL with fallback to bloginfo values * **NEW**: Context-aware relations – isPartOf and mainEntityOfPage (featured images only) for better search engine understanding * **NEW**: Keywords from tags/categories – Automatic keyword extraction from post tags and categories * **FIX**: Server compatibility issue – MIME type detection now uses 5-level fallback system for servers without Fileinfo extension * **DATABASE**: Post meta caching system – _imgseo_file_hash, _imgseo_exif_cache, _imgseo_sd_cache for optimal WordPress performance * **UX**: Enhanced admin interface – JavaScript-powered field dependencies and visual feedback for structured data settings #### 2.4 * **UX IMPROVEMENT**: Replaced all alert popups with inline error messages – Better user experience with non-intrusive error notifications * **NEW**: Credit limitation information box – When credits are insufficient for all images, a clear statistics box appears in Processing Status section showing how many images will be processed * **ENHANCED**: Improved insufficient credits error messages – Added direct purchase link to dashboard.imgseo.net/subscription and information about 10 free daily credits * **ENHANCED**: Error messages now display inline in both bulk generation and single image generation with helpful links and actionable information * **CLEANUP**: Removed “Log Retention (Days)” setting from Renamer settings – Log cleanup now hardcoded to 7 days (setting was no longer needed as log UI was removed) * **SECURITY**: Invalid API tokens are now immediately deleted from database instead of being stored – Prevents recurring validation requests * **CRITICAL FIX**: Bulk-specific settings (update_title, update_caption, update_description, processing_speed) now properly override global settings – Previously bulk form options were ignored * **NEW**: Image format validation – Unsupported formats (SVG, ICO, etc.) are now automatically skipped during processing. Supported formats: JPEG, PNG, WebP, AVIF, HEIC, BMP, GIF, TIFF * **NEW**: File-based logging for bulk operations – Logs are now written to files instead of database to prevent database bloat. Log files stored in wp-content/ uploads/imgseo-logs/ with automatic cleanup after 7 days * **PERFORMANCE**: Fixed N+1 query problem in batch processor – Changed from individual get_post() calls to single get_posts() query (1000 images: from 1001 queries to 2 queries) * **PERFORMANCE**: Optimized retry logic – Reduced from 2-3 seconds blocking sleep() to 0.5 seconds non-blocking usleep() – Retry 4x faster * **PERFORMANCE**: Optimized JS polling – Status check now every 5 images instead of every single image – 80% reduction in AJAX calls during bulk processing * **PERFORMANCE**: Pre-load metadata cache before processing loop – Eliminates redundant database queries for alt text and title checks * **DATABASE**: Reduced database usage – Bulk processing logs no longer stored in database (moved to file system) * **QUALITY**: Increased thumbnail threshold from 3MB to 5MB – Original images used more often for better AI analysis quality * **DATABASE**: Added new columns to jobs table (update_title, update_caption, update_description, processing_speed) with automatic migration for existing installations * **CLEANUP**: Updated reset and uninstall functions to properly clean up file- based logs and all related transients * Fixed: Manual token verification now ignores local temporary block, allowing immediate retry with valid keys * Fixed: Improved error messages for API token verification to distinguish between invalid keys and server blocks * Documentation: Added clarification on which settings apply to Bulk Generator ( Renamer/Compression skipped) * Verified: “Force Base64” transfer mode confirmed fully operational across all tools including Bulk Generator #### 2.3 * New Feature: Added support for Image Sitemaps (XML). #### 2.2.1 * **CRITICAL FIX**: Accessibility badge memory exhaustion – Completely refactored badge rendering to prevent crashes on sites with 1000+ images * **CRITICAL FIX**: Base64 image upload system now works correctly for metadata generation – Previously ignored `imgseo_always_use_base64` setting * **CRITICAL FIX**: Checkbox settings not saving – Fixed all checkbox settings ( 10+ affected) that couldn’t be disabled after enabling * **PERFORMANCE**: Badge queries reduced from 5000+ to 2 queries with 10-minute cache – 99.96% query reduction, 10000x faster page loads * **PERFORMANCE**: Eliminated N+1 query problem in badge – No longer loads all images into memory (was causing 150MB+ memory usage) * **BUGFIX**: Fixed “generate_metadata()” function to support base64 method, bypassing protected images (Shield Security, SiteGround Security) * **BUGFIX**: Fixed bulk generation count discrepancy – Now accurately counts only processable images instead of showing inflated numbers * **BUGFIX**: Fixed accessibility badge width appearing too wide on some themes– Added proper CSS constraints (max-width, object-fit) * **IMPROVEMENT**: Added intelligent validation using `wp_attachment_is_image()` to filter out corrupted/missing images from bulk count * **ENHANCEMENT**: New diagnostic notice shows orphaned image records in database with cleanup recommendations * **STABILITY**: Improved error handling for badge rendering (wp_count_posts, transient cache, database queries, division by zero) * **STABILITY**: Job table badges now handle NULL values and corrupted records gracefully with proper fallbacks * **SECURITY**: Enhanced HTML escaping for all badge outputs and inline styles * **UX**: Eliminated confusion where bulk page showed “2037 images” but processing reported “0 images to process” * **UX**: Checkbox settings now properly save unchecked (0) state using hidden input field pattern * **COMPATIBILITY**: Fixed potential crashes on sites with corrupted attachment records or missing files * **OPTIMIZATION**: Added lazy loading to accessibility badge image #### 2.1.5 * **PERFORMANCE**: Major optimization update – Reduced database queries from ~150 to ~40 per page load * **PERFORMANCE**: Fixed memory exhaustion in bulk operations – Changed to paginated queries (100 images/batch) instead of loading all images at once * **PERFORMANCE**: Disabled autoload for 35+ non-critical options – Reduced memory usage on every page load * **PERFORMANCE**: Fixed N+1 query problem – Implemented meta cache preloading reducing queries from 1000+ to ~40 in bulk operations * **PERFORMANCE**: Smart thumbnail fallback – Images >3MB automatically use WordPress thumbnails, reducing bandwidth by 70-90% * **PERFORMANCE**: Cached expensive COUNT queries with 5-minute transients * **PERFORMANCE**: Conditional hook registration – Sitemap hooks only loaded when feature is enabled * **PERFORMANCE**: Removed HTTP HEAD checks in image processing loops – WordPress thumbnails now trusted to exist * **PERFORMANCE**: Implemented option caching system with get_cached_option() method * **BUG FIX**: Improved base64 fallback detection – Added “Buffer too small” and“ not a valid image” error detection for automatic fallback * **BUG FIX**: Better handling of hotlink protection, CDN issues, and HTML redirects * **CODE QUALITY**: WordPress Coding Standards (PHPCS) compliance – All code now passes WordPress.org validation * **CODE QUALITY**: Fixed variable naming conventions – All template variables prefixed with ‘imgseo_’ * **CODE QUALITY**: Fixed hook naming conventions – Changed to ‘imgseo_https_local_ssl_verify’ with proper prefix * **CODE QUALITY**: Added phpcs:ignore comments for intentional WordPress core hooks usage * **CLEANUP**: Removed 14 unused files (~190KB) – Legacy code, compression beta feature, backup files * **CLEANUP**: Removed compression feature (beta was incomplete and never activated) * **OPTIMIZATION**: Typical API payload reduced from 5-15MB to 200KB-1MB per image * **OPTIMIZATION**: Bulk processing speed improved by ~40% * **OPTIMIZATION**: Memory usage reduced by ~50-60% in bulk operations * **DEBUG MODE**: Default debug mode now disabled (set IMGSEO_DEBUG_MODE = false)– Enable in wp-config.php when needed * **DEBUG MODE**: All JavaScript console.log statements now protected by debug mode checks #### 2.1.3 * **CRITICAL FIX**: Resolved 403/202 errors on sites with hotlink protection and CDN anti-bot – Plugin now correctly uses base64 method when option is enabled * **BUG FIX**: Fixed base64 option being ignored in generate_alt_text_no_credit_consumption() method – Previously only checked in generate_alt_text() * **BUG FIX**: Added proper type casting for imgseo_always_use_base64 option to prevent PHP type juggling issues – String ‘0’ was incorrectly evaluated as truthy * **ENHANCEMENT**: Improved automatic fallback system – Now detects 202 status codes, HTML redirects, and anti-bot protection errors * **ENHANCEMENT**: Extended fallback trigger conditions to include “error downloading image”, “failed to download”, “access forbidden”, “HTML error page” messages * **COMPATIBILITY**: Better support for sites using Cloudflare, SiteGround Security, and other CDN/WAF protection systems * **DEFAULT CHANGE**: Base64 image transfer now enabled by default (imgseo_always_use_base64 = 1) to prevent download errors on protected sites * **RELIABILITY**: Ensures consistent behavior between manual and automated alt text generation processes #### 2.1.2 * **MINOR BUGS**: Some compression bugs. #### 2.1.1 * **INTERNATIONALIZATION**: Complete plugin internationalization – All hardcoded Italian strings converted to English with WordPress translation functions * **COMPATIBILITY FIX**: Comprehensive compatibility system between Image Renamer and Compression features * **CROSS-PLUGIN SUPPORT**: Added compatibility with major compression plugins ( ShortPixel, WP Smush, TinyPNG, Imagify, Optimole, EWWW, Kraken) * **AUTOMATIC SYNC**: Smart backup path synchronization when renaming images compressed by third-party plugins * **METADATA CLEANUP**: Intelligent cleanup of orphaned compression metadata to prevent inconsistent states * **SEO CONFLICT RESOLUTION**: Fixed SEO plugin conflicts caused by global wp_redirect filter interference * **TARGETED REDIRECTS**: Improved redirect handling with automatic filter removal to prevent conflicts with other plugins * **ENHANCED MESSAGING**: Clarified compression cost messaging – “0.1 credits for each individual image/thumbnail that gets compressed” * **PLUGIN DETECTION**: Automatic detection and logging of active compression plugins for better compatibility debugging * **ERROR HANDLING**: Improved error messages and JavaScript escaping for better security and user experience * **PERFORMANCE TUNING**: Optimized bulk operation timing (polling: 6s, delay: 200ms) for better server performance * **SYNTAX FIXES**: Resolved PHP parse errors in JavaScript strings and improved code consistency across all files #### 2.1.0 * **NEW FEATURE**: Introduced **Image Compression System** (Beta) – Advanced multi- format image compression with modern format support * **Multi-Format Support**: Compress to JPEG, PNG, WebP, and AVIF formats with intelligent quality optimization * **Advanced Quality Control**: Separate quality settings for each format (JPEG: 80%, WebP: 50%, AVIF: 30% for optimal compression) * **Smart Format Detection**: Automatic detection and display of existing compressed formats with visual indicators * **Modern Format Fallback**: Advanced picture element generation with browser- specific format serving (.htaccess integration) * **Beta Safety Features**: Beta disclaimers and warnings for AVIF processing ( high resource consumption) * **API Integration**: Enhanced API timeout handling with retry logic for 502/503/ 504 errors and exponential backoff * **Credit Management**: Improved credit display with decimal precision and float conversion for accurate accounting * **URL Fixes**: Corrected purchase links from ai.imgseo.net to dashboard.imgseo. net * **Bulk Compression**: Temporarily disabled bulk compression feature for stability( files preserved for future release) * **Code Cleanup**: Removed debug messages and improved WordPress Codex compliance for production use #### 2.0.0 * **MAJOR UPDATE**: Introduced revolutionary **Bulk Rename System** with parallel processing capabilities for mass image renaming * **Performance Breakthrough**: New parallel processing engine up to **16x faster** than sequential processing (Insane mode: 16 parallel requests, 0.2s intervals) * **Critical Bug Fixes**: Resolved all JavaScript syntax errors in admin-script. js (virgola extra, parentesi mancanti) and PHP syntax errors in bulk-page.php and class-imgseo-settings.php * **Advanced Safety System**: Multi-layer confirmation system with danger zone warnings, triple confirmation checkboxes, and final warning modals for bulk operations * **Dual Processing Methods**: AI-Powered rename (intelligent filenames based on image content) and Pattern-Based rename (customizable templates with dynamic variables) * **Real-time Monitoring**: Live progress tracking with terminal-style logs, active request counters, and estimated completion times * **Intelligent Job Management**: Background job processing with unique IDs, transient storage, and safe stop/resume functionality * **Professional UI**: Complete redesign of bulk rename interface with responsive design, progress bars, and status indicators * **Enhanced Error Handling**: Robust error management with specific status codes( 500, 403, 0), timeout protection, and network error recovery * **Processing Speed Options**: Configurable parallel processing (Safe: 2 parallel, Normal: 4 parallel, Fast: 6 parallel, Ultra: 12 parallel, Insane: 16 parallel) * **Advanced Preview System**: Complete preview of all changes before execution with conflict detection and statistics summary * **Smart Selection Tools**: Multiple image selection methods (Select All, Custom Selection via WordPress media picker, Advanced Filtering) * **File Processing Options**: Lowercase conversion, accent removal, duplicate handling, and intelligent filename sanitization * **Comprehensive Logging**: Detailed operation logs with timestamps, success/error tracking, and export capabilities * **Seamless Integration**: Full integration with existing renamer system, maintaining backward compatibility and log consistency #### 1.2.9 * **Enhanced**: Improved credit management system for better reliability * **Optimized**: Enhanced API request handling and error management * **Stability**: Better resource allocation and processing efficiency #### 1.2.8 * **UI**: UI improvements #### 1.2.7 * **SECURITY**: Fixed potential API key exposure in error logs * **SECURITY**: Added path traversal protection – File operations now validate paths are within upload directory * **SECURITY**: Enhanced AJAX input validation – Added API key format validation and malicious pattern detection * **SECURITY**: Implemented rate limiting – Maximum 5 API verification attempts per 10 minutes per user * **SECURITY**: Added attachment ID validation helper – Ensures proper permission checks for all file operations * **SECURITY**: Strengthened sitemap file generation – Additional path validation before writing sitemap files * **Improved**: Enhanced security logging – Path traversal attempts are now logged without exposing sensitive data #### 1.2.6 * **NEW**: Redesigned Image Sitemap Management System – Replaced single “Generate Sitemap” button with intuitive ACTIVATE and REFRESH buttons for better user control * **NEW**: Automatic Sitemap Updates – Added scheduled auto-refresh functionality with configurable intervals (hourly, daily, weekly) * **Enhanced UX**: Smart notification system alerts users when sitemap needs updating after new image additions * **Improved Performance**: Static sitemap generation with automatic permalink rule updates eliminates 4xx errors and reduces server load * **Better Control**: Manual refresh capability combined with intelligent auto- updates ensures sitemaps stay current without constant manual intervention * **Streamlined Interface**: Cleaner admin interface with status indicators and auto-refresh settings for optimal sitemap management #### 1.2.5 * **FIXED**: Resolved PHP 8.3 deprecation warnings – Added proper property declarations to IMGSEO_Init class * **PHP 8.3 Compatibility**: Eliminated “Creation of dynamic property” deprecation notices * **Improved Code Quality**: Enhanced class structure with explicit property declarations * **Cleaner Logs**: No more PHP deprecation warnings filling up debug logs * **Modern PHP Support**: Full compatibility with latest PHP versions and best practices #### 1.2.4 * **FIXED**: Resolved widget content loss issue during modifications – Removed interfering hook that caused widget data reset * **FIXED**: Eliminated debug log spam in console – Implemented centralized debug control system (IMGSEO_DEBUG_MODE) to drastically reduce log messages * **Improved Stability**: Widgets can now be modified without losing saved content * **Clean Console**: No more excessive debug messages in logs (only activatable when needed) * **Widget Compatibility**: Enhanced compatibility with all WordPress widget types * **Performance**: Reduced system log load by eliminating unnecessary debug messages #### 1.2.3 * **NEW**: Implemented robust fallback mechanism – Automatically detects 403 Forbidden errors (hotlinking protection) and 5xx server errors (including 520 Cloudflare) and uses alternative method with base64 and WordPress thumbnails * **NEW**: Added option to always force base64 method usage – Complete bypass of anti-hotlinking protections and Cloudflare blocks * **Performance Optimization**: Uses WordPress thumbnails (large medium_large medium) instead of original images to reduce transmitted data size * **Improved Compatibility**: Now works with sites implementing anti-hotlinking security measures or when remote servers have temporary issues * **Enhanced Reliability**: Resilient system that ensures alt text generation even with connection errors or temporary server-side problems * **User Control**: Option to always choose base64 method for situations where image access problems occur #### 1.2.2 * **NEW**: Added dedicated AI prompt for WooCommerce product images – Enhanced e-commerce optimization with specialized prompts that generate more accurate and conversion-focused alt text for product images * **Enhanced WooCommerce Integration**: Improved product image recognition and context-aware descriptions for better SEO and accessibility compliance * **E-commerce Optimization**: Specialized AI prompts now consider product attributes, categories, and commercial context for more effective product image descriptions #### 1.2.1 * **MAJOR FIX**: Resolved homepage image detection – now generates JSON-LD for ALL images on homepage (not just 2) * **Enhanced Image Scanning**: New universal scanner detects images from posts, widgets, themes, and external sources * **Improved Statistics**: Accurate JSON-LD statistics with clear quality metrics( complete vs partial data) * **Simplified Admin Interface**: Streamlined structured data settings page for better user experience * **Bug Fix**: Corrected PHP syntax error in universal scanner class * **Performance**: Optimized scanning system with intelligent caching and conditional execution * **Better Coverage**: Now detects images from page builders, CDN, FTP uploads, and CSS backgrounds #### 1.2.0 * Added JSON-LD structured data generation for images * Enhanced SEO with automatic Schema.org ImageObject markup * New admin settings for structured data configuration #### 1.1.9 * Added Image Sitemap Generation. #### 1.1.8 * Minor changes. #### 1.1.7 * Minor changes. * Added checkbox for adding a complianz badge for alternative texts. #### 1.1.6 * Bulk mode upgraded. * Improved compatibility with older MySQL versions. #### 1.1.5 * Minor changes. #### 1.1.4 * Minor bug fixes. #### 1.1.3 * Minor bug fixes. #### 1.1.2 * Minor bug fixes. #### 1.1.1 * Minor bug fixes. #### 1.1.0 * Major update – New API and many fixes. #### 1.0.9 * AI engine enabled for renamer. * Added numerous options for renaming. * Added renamer support for major builder plugins. * Updated missing English strings. #### 1.0.8 * Added English as main language. #### 1.0.7 * Added support for major languages. * UX improvements in bulk actions section. #### 1.0.6 * 10 free credits daily refill when balance < 10. #### 1.0.5 * New plugin structure and improvements. * Enhanced image renamer with proper thumbnail handling. * Added restore functionality. * Fixed 404 prevention and detailed logging. * Added custom prompt field. #### 1.0.4 * Bug fixes. #### 1.0.2 * Enhancing usability. #### 1.0.1 * Improved Max Characters option, Page Title option, and alt text column display. * Optionally set image title, caption and description with generated alt text. #### 1.0.0 * Initial release with alt text generation and AI image renaming. ## Meta * Version **2.7.2** * Last updated **3 weeks ago** * Active installations **400+** * WordPress version ** 5.0 or higher ** * Tested up to **6.9.4** * PHP version ** 7.3 or higher ** * Tags * [AI alt text](https://wordpress.org/plugins/tags/ai-alt-text/)[image seo](https://wordpress.org/plugins/tags/image-seo/) [schema markup](https://wordpress.org/plugins/tags/schema-markup/) * [Advanced View](https://wordpress.org/plugins/imgseo-ai-alt-text-generator/advanced/) ## Ratings 5 out of 5 stars. * [ 10 5-star reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/reviews/) ## Contributors * [ pianoweb ](https://profiles.wordpress.org/pianoweb/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/imgseo-ai-alt-text-generator/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://imgseo.net/)