Docs · Pewit AI Media Toolkit
Generating Metadata
ALT, title, caption, description — modes, single image, Media Library, and bulk jobs.
The plugin can generate up to four fields per image:
- ALT text (
_wp_attachment_image_alt) — accessibility & image SEO - Title — attachment post title
- Caption — excerpt
- Description — post content
Choose which fields to write in Settings → Metadata fields.
Generation modes
| Mode | Behavior |
|---|---|
| Balanced | Natural, accurate descriptions |
| SEO | Keyword-aware where context allows |
| WCAG | Accessibility-first ALT (decorative vs informative, no “image of…”) |
Set default in Settings → Generation mode.
Smart complete vs regenerate all
| Behavior | When |
|---|---|
| Smart complete | Default — only fills empty fields (respects field toggles) |
| Regenerate all | Overwrites existing values — use when refreshing bad legacy ALT |
Single-image Generate in the Images table uses smart complete unless you choose otherwise in Media Library actions.
Where you can generate
1. Images table (admin)
- Run Scan images.
- Open Images, filter e.g. “Missing ALT”.
- Click Generate on a row (Free + Pro).
2. Native Media Library (since 1.0)
On upload.php and in the attachment sidebar:
- Generate metadata — all configured fields
- Change filename (Pro) — SEO rename for one file
Requires Save & Test API key first.
3. Background jobs (Pro)
- Generate all missing ALT in background
- Complete all incomplete metadata in background
- Generate ALL + SEO filename — metadata + rename in one job
See Background jobs.
Language
Language mode in Settings:
- Auto — per image via WPML / Polylang / locale
- Force global — one language for every generation
Global website context steers vocabulary (e.g. “bike rental Tenerife, friendly tone”).
What gets skipped
By default the scan may skip:
- SVG (optional)
- Very small images (min width/height)
- Obvious icons/logos by filename pattern
- Unsupported MIME types
Adjust in Settings if you need broader coverage.
After generation
- Details on a row shows current metadata.
- Change history (Pro) lists changes with Restore.
- Analysis may flag duplicates or low quality text — run Analyze duplicates & quality.
Tips
- Set global context once — improves every image on the site.
- Use only used images for first bulk pass — saves money.
- Run Analyze before and after to show client improvement.
- For WooCommerce, scan with products published so usage detection finds gallery context.
Next: Background jobs · Settings reference