Docs · AI Media Toolkit
Getting Started
Install AI Media Toolkit, connect OpenAI, run your first scan and generate metadata.
AI Media Toolkit improves image metadata (ALT, title, caption, description), SEO filenames, and featured images in WordPress using OpenAI — with backups and rollback before risky changes.
What you need
| Requirement | Details |
|---|---|
| WordPress | 6.0 or newer |
| PHP | 7.4+ (tested up to 8.3) |
| OpenAI API key | Your own key (BYOK). Setup guide → |
| Time | ~5 minutes for first setup |
ChatGPT Plus ≠ API key. You need an API key from platform.openai.com with billing enabled.
Installation
- In WordPress go to Plugins → Add New → Upload Plugin.
- Upload
ai-media-toolkit-x.x.x.zipfrom Freemius or your purchase email. - Activate the plugin.
- Open AI Media Toolkit in the admin sidebar.
The plugin folder must stay ai-media-toolkit/ with main file ai-media-toolkit.php.
First-run onboarding
On first visit you’ll see a short wizard:
- Connect OpenAI — paste API key in Settings → Save & Test
- Scan your library — finds missing ALT, incomplete metadata, bad filenames
- Generate — one image (Free) or bulk in background (Pro)
You can skip and reopen Settings anytime from the sidebar.
Quick workflow (5 steps)
Settings → Save & Test API
↓
Dashboard → Scan images
↓
Images → filter “Missing ALT” or “Incomplete metadata”
↓
Generate (single) OR Start background job (Pro)
↓
Optional: SEO rename, export CSV report, featured images
Free vs paid at a glance
| Task | Free | Pro / Agency |
|---|---|---|
| Scan library + basic CSV | ✅ | ✅ |
| Generate metadata one image at a time | ✅ | ✅ |
| Background bulk generation | — | ✅ |
| SEO filename rename / replace | — | ✅ |
| Backups, rollback, emergency repair | — | ✅ |
| Quality analysis, email job reports | — | ✅ |
| Featured image AI + fill missing | — | ✅ |
| White-label (your brand in admin) | — | Agency only |
Details: Plans & pricing →
Safety first
Before any filename change or file replace:
- Enable Auto-backup in Settings (on by default).
- Test on staging for WooCommerce stores.
- Renames keep the same attachment ID — page builders and WooCommerce references by ID stay connected.
More: Backups & recovery →
Next steps
- How it works — scan, context, AI, why it’s safe
- OpenAI API key — step-by-step BYOK
- Generating metadata — modes and fields
- FAQ — common errors and fixes