About this plugin
Webangon Image Optimizer is a complete Media Library toolkit built around four everyday WordPress needs: safely clean unused images, regenerate thumbnails after design or migration changes, convert images to WebP/AVIF for faster delivery, and replace media files without breaking attachment IDs.
Benefits for WordPress users:
- Find unused Media Library images with a safe dry scan before deletion.
- Protect images used in Elementor, post content, featured images, WooCommerce galleries, widgets, theme/plugin options, SEO fields, and more.
- Regenerate thumbnails after theme changes, imports, migrations, or image-size updates.
- Remove old generated thumbnail files while keeping original/main images.
- Convert images to WebP or AVIF for better performance.
- Rewrite image URLs across posts, post meta, Elementor data, and options after conversion.
- Replace an existing Media Library file without breaking the attachment ID used by posts, builders, products, and galleries.
- Optionally use a new replacement file name and update old file links across the database.
- Run image cleanup, thumbnail, and conversion tasks from WP-CLI.
The admin screen is available under Media > Image Optimizer.
Media replacement is available contextually from the Media Library row actions and attachment edit screen. Click Replace media or Upload a new file on an attachment.
WP-CLI Commands
Image cleaner:
wp webangon-image-optimizer clean wp webangon-image-optimizer clean --older-than=30 wp webangon-image-optimizer clean --deep-meta wp webangon-image-optimizer clean --include-revisions wp webangon-image-optimizer clean --skip-options wp webangon-image-optimizer clean --batch=200 wp webangon-image-optimizer clean --delete wp webangon-image-optimizer clean --delete --yes
Thumbnail regeneration:
wp webangon-image-optimizer thumbnails regenerate wp webangon-image-optimizer thumbnails regenerate --sizes=thumbnail,medium,large wp webangon-image-optimizer thumbnails regenerate --delete-old wp webangon-image-optimizer thumbnails regenerate --from-original wp webangon-image-optimizer thumbnails regenerate --ids=12,34,56 wp webangon-image-optimizer thumbnails regenerate --dry-run
Thumbnail purge:
wp webangon-image-optimizer thumbnails purge wp webangon-image-optimizer thumbnails purge --backups wp webangon-image-optimizer thumbnails purge --ids=12,34,56 wp webangon-image-optimizer thumbnails purge --dry-run wp webangon-image-optimizer thumbnails purge --yes
WebP / AVIF conversion:
wp webangon-image-optimizer convert --format=webp --quality=82 wp webangon-image-optimizer convert --format=avif --quality=70 wp webangon-image-optimizer convert --format=webp --quality=82 --delete-old wp webangon-image-optimizer convert --format=webp --regen wp webangon-image-optimizer convert --ids=12,34,56 --format=webp wp webangon-image-optimizer convert --format=webp --skip-rewrite wp webangon-image-optimizer convert --format=webp --rewrite-only wp webangon-image-optimizer convert --format=webp --dry-run wp webangon-image-optimizer convert --format=webp --quality=82 --yes
Recommended Workflow
- Take a full file and database backup.
- Run Image Cleaner in dry scan mode before deleting anything.
- Regenerate thumbnails after changing theme image sizes or after imports/migrations.
- Convert to WebP first for broad compatibility, or AVIF when the hosting stack supports it.
- Use Replace media when you need to update a file while keeping the same attachment record.
- Test important pages, Elementor templates, product galleries, and image-heavy pages after conversion or replacement.