Docs · Pewit AI Media Toolkit
Background Jobs
Bulk metadata, SEO rename, featured image fill — queue, pause, email reports.
Pro / Agency feature. Large libraries run through a background queue powered by WP-Cron — you can close the browser.
Starting a job
From Dashboard → Quick actions or Images:
| Button | Job type |
|---|---|
| Generate all missing ALT in background | missing_alt |
| Complete all incomplete metadata | incomplete |
| Bulk SEO rename bad filenames | seo_rename_bad |
| Bulk SEO rename all listed | seo_rename_all |
| Generate ALL + SEO filename | generate_all_with_filename |
| Generate featured images for missing posts | featured_image_fill (Settings) |
You can also scope jobs to the current filter/search or selected rows from the Images table.
While a job runs
The Background job panel shows:
- Status, progress %, processed / failed / skipped
- ETA after a few items
- Current item step (metadata, rename, featured image, etc.)
- Live Activity Log — exportable
Controls: Pause, Resume, Stop, Clear.
Batch settings
Settings → Performance
- Batch size — images per cron tick (default 5; featured images run 1 at a time)
- Batch delay — seconds between batches (API rate limiting)
If your host has slow cron, jobs still advance — just slower. Do not rely on “Visit Site” cron plugins unless necessary.
Email notifications
Settings → Email notifications
- Send when job completes
- Optional: only if failures, include failed list, filename changes, CSV attachment
- Report level: basic / detailed / full
- Minimum job duration before sending (avoid spam on tiny jobs)
Job completion
When finished:
- Scan stats refresh on next Scan or page reload
- CSV email attachment (if enabled) uses formula-safe escaping
- Backup operation closes if one was opened for the job
Featured image fill jobs
Separate from metadata jobs:
- Finds published posts without featured image
- Generates from title + content using your style preset
- One post per batch (slow API)
- Uses same OpenAI billing as manual featured generation
Configure in Settings → Featured image AI.
Free plan
Free users see upsell on Pro actions. Free can still:
- Scan
- Generate one image at a time
- Export basic CSV
Troubleshooting
| Issue | Check |
|---|---|
| Job stuck at 0% | WP-Cron disabled? Trigger cron or use a real cron hitting wp-cron.php |
| Many failures | API key, quota, unsupported images |
| Job stopped mid-way | User clicked Stop, or API key became invalid |
| Woo images wrong after rename job | Stop job → Emergency repair → rollback backup |
Next: SEO filenames · Backups