Description
Webangon Image Optimizer gives WordPress users one place to manage heavy image maintenance tasks. It helps reduce storage, improve image delivery, rebuild thumbnails after theme or migration changes, and run large jobs from WP-CLI.
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.
- Run image cleanup, thumbnail, and conversion tasks from WP-CLI.
The admin screen is available under Media > Image Optimizer.
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.
- Test important pages, Elementor templates, product galleries, and image-heavy pages after conversion.
Installation
- Upload the
webangon-image-optimizerfolder to/wp-content/plugins/. - Activate Webangon Image Optimizer from the Plugins screen.
- Go to Media > Image Optimizer.
FAQ
-
Does this replace the three separate image plugins?
-
Yes. It combines image cleanup, thumbnail regeneration, and WebP/AVIF conversion into one plugin.
-
Should I delete files immediately?
-
No. Run dry scans first and keep a full backup before using destructive actions.
-
Does AVIF work on every server?
-
No. AVIF conversion requires PHP GD support for
imageavif().
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Webangon Image Optimizer” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Webangon Image Optimizer” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial merged plugin release.
