FAQ & Troubleshooting
Common questions, errors, WooCommerce issues, cron, API.
General
Do I need an OpenAI subscription (ChatGPT Plus)?
No. You need an API key from platform.openai.com with billing enabled. ChatGPT Plus is separate.
Will renaming break my images?
Not if references use attachment IDs (WooCommerce, most builders). AIMT keeps the ID. Always enable backups; test on staging.
Can I use this on WordPress.com?
Self-hosted WordPress only (.org). Requires plugin upload and cron.
Is image data sent to PEWIT Labs?
In BYOK mode, images go from your server to OpenAI on your key. See Privacy Policy.
API errors
| Message | Solution |
|---|---|
| Connect and test API key | Settings → paste key → Save & Test |
| Incorrect API key | Re-copy; create new key |
| Quota exceeded | OpenAI billing / spend limit |
| Model not found | Set model to gpt-4o-mini |
Generation
Generate button disabled
Image may be skipped: SVG, too small, unsupported type — check skip reason in Images table.
Wrong language
Set Language mode or check WPML/Polylang assignment for the parent post.
Generic / poor ALT
Add global context, switch to WCAG or SEO mode, or regenerate with better usage detection (Balanced → Debug temporarily).
Duplicates everywhere
Run Analyze → consider Regenerate all on duplicates or manual edit; future: duplicate resolver (roadmap).
Background jobs
Job never progresses
- Host blocking WP-Cron → real cron on
wp-cron.php - Plugin Stop was clicked
- PHP timeout on cheap hosting — reduce batch size, increase delay
Job many failures
Check Live log for API errors; verify images still exist on disk.
WooCommerce
Product images disappeared / tiny thumbnails
- Stop jobs
- Emergency repair
- Or Rollback latest backup operation
- Filter Broken / missing sizes → repair/regenerate
Gallery order wrong after replace
Rare — rollback backup; avoid replace during peak traffic.
Featured images
Publish hangs
Auto-generate runs synchronously on publish — normal for DALL·E; consider disabling auto and using bulk fill overnight.
Style inconsistent
Use style preset + custom prompt; same settings apply to editor and bulk fill.
Pro / license
Pro features locked
Activate license in Freemius account; sync in WP admin. Trial expired → renew or upgrade.
“Pro feature” upsell on Free
Expected — bulk/backup/rename require Pro or Agency.
Support
- Documentation — this site
/docs/ai-media-toolkit/ - Email — support@pewitlabs.com (Pro/Agency priority)
- Free — docs + community
Include: WP version, PHP version, AIMT version, steps to reproduce, screenshot of error.