AI Image SEO
AI-assisted image attribute generation for alt text, captions, and optional image titles.
License + Configuration
AI Image SEO requires a Pro, Business, or Agency license and a configured AI provider (OpenAI, Claude, or Gemini).
Where Image SEO Lives
Settings and generation actions are split across the AI Tools admin and the Media Library.
AI Tools → Image SEO (Settings)
- • Enable/disable generation globally
- • Generate on upload toggle
- • Alt/caption/title output toggles
- • Overwrite existing values option
- • Context mode and language selection
Media Library & Block Editor (Actions)
- • Per-image generate button in attachment panels
- • Block editor image control helper
- • Media Library bulk action for batch generation
- • Progress feedback during bulk processing
Generation Paths
1) Media Library & Editor Helpers
Uses the /prorank-seo/v1/ai/suggest-image-attrs/:id endpoint for per-image generation and bulk actions in the Media Library.
- Per-image generate button in attachment detail panels
- Block editor image toolbar helper
- Media Library bulk action for batch processing
2) Media Library and Block Editor Helpers
Uses /prorank-seo/v1/ai/suggest-image-attrs/:id for quick generation in attachment panels and editor image controls.
- Single-image generate button
- Bulk actions inside media screens
- Progress feedback during batch processing
3) AI Image Attributes Settings
Settings endpoint: /prorank-seo/v1/ai/image-attributes-settings
- Enable/disable generation globally
- Generate on upload toggle
- Generate alt/caption/title toggles
- Overwrite existing values option
- Context mode and language selection
Setup Checklist
- Configure AI provider and API key in AI configuration.
- Open AI Image Attributes settings and choose generation flags.
- Start with a small batch in Media Library to validate output style.
- Enable “Generate on Upload” only after the first validation pass.
The module now respects runtime settings consistently across upload, bulk, manual form, and AJAX paths.
Common Issues
AI Not Configured
Configure provider and API key before running generation.
No Updates on Existing Images
Existing alt/caption/title values are preserved unless overwrite is enabled.
Bulk Generation Errors
If generation is disabled in Image SEO settings, bulk or manual runs return a feature-disabled error. Re-enable generation in AI Tools → Image SEO settings to resolve.
Notes on Scope
This module currently focuses on generation workflows and settings. Do not rely on separate “analytics/cost/export” dashboards unless they are explicitly present in your installed build.
For consistent quality, test on a representative image sample before running large bulk jobs.