Webangon Image Optimizer

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

1. Take a full file and database backup.
2. Run Image Cleaner in dry scan mode before deleting anything.
3. Regenerate thumbnails after changing theme image sizes or after imports/migrations.
4. Convert to WebP first for broad compatibility, or AVIF when the hosting stack supports it.
5. Use Replace media when you need to update a file while keeping the same attachment record.
6. Test important pages, Elementor templates, product galleries, and image-heavy pages after conversion or replacement.