AI Product Image Builder helps your WooCommerce store generate professional, context-aware product images automatically using AI providers.
Setup and Configuration
↑ Back to top
Tested compatibility: WordPress 7.0 and WooCommerce 10.7.0.
Getting started
↑ Back to top- Go to WooCommerce > AI Image Builder > Settings.
- Select your provider: OpenAI (GPT Image) or Google Gemini.
- Enter your API key.
- OpenAI key: OpenAI Platform.
- Google key: Google AI Studio.
- For OpenAI, choose model: Current (Legacy), GPT Image 1.5, or GPT Image 2.
- For Google, choose a Gemini image model (stable/preview or legacy options in dropdown).
- Choose image size and background mode, then save settings.
Note: Imagen 4 models require a separate Vertex AI integration path and are not selectable in the current Gemini API dropdown.
Generating Images
↑ Back to topProduct Page
On any product edit page, locate the AI Image Builder meta box.
- Select a saved prompt or write your own prompt.
- Optionally click Enhance to improve the prompt with AI.
- Select target: Gallery Variant (Image-to-Image) or Featured Image (Text-to-Image).
- Click Generate.
- Review results in preview/lightbox and save successful prompts as new templates if needed.
Auto-Generation
Enable Auto-generate on save in Settings to generate an image when a product is saved and its gallery is empty.
Tip: Prompts support placeholders like {{product_title}}, {{product_description}}, and {{product_excerpt}}.
Batch Generation (inside product editor)
- Use the slider to generate 1 to 5 images in one run.
- Review all generated options in the multi-preview modal.
- Regenerate specific options with edited prompts and keep only the best result.
Bulk Generation
Use the Bulk tab to generate images for many products via CSV.
- CSV columns:
sku,prompt,image_count(optional, 1-5). - CSV validation checks SKU existence and required fields.
- Background processing with progress tracking and downloadable result CSV.
- Result CSV includes:
sku,status,image_url,error.
Bulk processing method: choose Standalone CLI Process (recommended) or Action Scheduler in Settings.
Bulk delay: configurable 1-60 seconds between API calls (default 5s).
Managing Prompts
↑ Back to top- Go to WooCommerce > AI Image Builder > Prompts.
- Create categorized prompt templates.
- Import/export prompts via CSV.
Troubleshooting
↑ Back to topCommon Issues
↑ Back to topAPI error: verify provider, API key, quota/billing, and model availability for your account.
Timeouts on bulk jobs: switch to Standalone CLI Process and/or increase bulk delay.
Permission denied: ensure WordPress can write to wp-content/uploads.
Enhance prompt says prompt is empty: update to latest plugin version with the prompt-field mapping fix.
FAQs
↑ Back to top
Do I need a separate subscription to use AI features?
Yes. You need your own API key from OpenAI or Google and pay usage directly to that provider.
Can I switch between models?
Yes. You can switch OpenAI models (Current/Legacy, GPT Image 1.5, GPT Image 2) from plugin settings without losing existing images or prompts.
Can I generate multiple product images at once?
Yes. Use in-product batch mode (1-5 images) or the Bulk tab with CSV for many products.
Will this slow down my website?
Heavy image generation is done by external AI providers. Your site mainly handles requests, result downloads, and media storage.
Where are generated images stored?
Generated files are saved in your WordPress Media Library and attached to products according to selected target.
I need help with a specific issue
Please open a support ticket with provider, model, product ID, and log details from the plugin Logs tab.
