Title: Webangon Image Optimizer Author: webangon Published: June 28, 2026 Last modified: June 29, 2026 --- Search plugins ![](https://ps.w.org/webangon-image-optimizer/assets/banner-772x250.png?rev=3588596) ![](https://ps.w.org/webangon-image-optimizer/assets/icon-128x128.gif?rev=3588772) # Webangon Image Optimizer By [webangon](https://profiles.wordpress.org/webangon/) [Download](https://downloads.wordpress.org/plugin/webangon-image-optimizer.zip) * [Details](https://kal.wordpress.org/plugins/webangon-image-optimizer/#description) * [Reviews](https://kal.wordpress.org/plugins/webangon-image-optimizer/#reviews) * [Installation](https://kal.wordpress.org/plugins/webangon-image-optimizer/#installation) * [Development](https://kal.wordpress.org/plugins/webangon-image-optimizer/#developers) [Support](https://wordpress.org/support/plugin/webangon-image-optimizer/) ## Description 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. ## Screenshots [⌊Image Cleaner tab showing dry-scan guidance, total image uploads, unused media results, protection switches, backup confirmation, and cleanup actions.⌉⌊Image Cleaner tab showing dry-scan guidance, total image uploads, unused media results, protection switches, backup confirmation, and cleanup actions.⌉[ Image Cleaner tab showing dry-scan guidance, total image uploads, unused media results, protection switches, backup confirmation, and cleanup actions. [⌊Thumbnails tab with selectable registered image sizes, regeneration options, start/ stop controls, and a separate tool for deleting generated thumbnail files.⌉⌊Thumbnails tab with selectable registered image sizes, regeneration options, start/stop controls, and a separate tool for deleting generated thumbnail files.⌉[ Thumbnails tab with selectable registered image sizes, regeneration options, start/ stop controls, and a separate tool for deleting generated thumbnail files. [⌊Image conversion settings showing WebP and AVIF support, automatic conversion for new uploads, output format, quality, and original-file options.⌉⌊Image conversion settings showing WebP and AVIF support, automatic conversion for new uploads, output format, quality, and original-file options.⌉[ Image conversion settings showing WebP and AVIF support, automatic conversion for new uploads, output format, quality, and original-file options. [⌊Whole-library conversion panel for converting existing media files and updating image URLs across posts, post meta, Elementor data, and options.⌉⌊Whole-library conversion panel for converting existing media files and updating image URLs across posts, post meta, Elementor data, and options.⌉[ Whole-library conversion panel for converting existing media files and updating image URLs across posts, post meta, Elementor data, and options. [⌊Attachment details screen with the Replace media field and Upload a new file button for replacing an existing Media Library item.⌉⌊Attachment details screen with the Replace media field and Upload a new file button for replacing an existing Media Library item.⌉[ Attachment details screen with the Replace media field and Upload a new file button for replacing an existing Media Library item. [⌊Replace media modal showing the current file, drag-and-drop new file upload area, replacement mode choices, date options, and upload controls.⌉⌊Replace media modal showing the current file, drag-and-drop new file upload area, replacement mode choices, date options, and upload controls.⌉[ Replace media modal showing the current file, drag-and-drop new file upload area, replacement mode choices, date options, and upload controls. ## Installation 1. Upload the `webangon-image-optimizer` folder to `/wp-content/plugins/`. 2. Activate Webangon Image Optimizer from the Plugins screen. 3. Go to Media > Image Optimizer. ## FAQ ### Does this replace the separate image/media plugins? Yes. It combines image cleanup, thumbnail regeneration, WebP/AVIF conversion, and media replacement 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()`. ### Can I replace a media file without changing its attachment ID? Yes. Use the Replace media action from the Media Library or attachment edit screen. The plugin replaces the file behind the existing attachment and regenerates metadata. ## 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. Contributors * [ webangon ](https://profiles.wordpress.org/webangon/) [Translate “Webangon Image Optimizer” into your language.](https://translate.wordpress.org/projects/wp-plugins/webangon-image-optimizer) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/webangon-image-optimizer/), check out the [SVN repository](https://plugins.svn.wordpress.org/webangon-image-optimizer/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/webangon-image-optimizer/) by [RSS](https://plugins.trac.wordpress.org/log/webangon-image-optimizer/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial merged plugin release with image cleanup, thumbnail regeneration, WebP/ AVIF conversion, and media replacement. ## Meta * Version **1.0.0** * Last updated **2 days ago** * Active installations **Fewer than 10** * WordPress version ** 5.8 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/webangon-image-optimizer/) * Tags * [AVIF](https://kal.wordpress.org/plugins/tags/avif/)[image optimization](https://kal.wordpress.org/plugins/tags/image-optimization/) [media cleaner](https://kal.wordpress.org/plugins/tags/media-cleaner/)[replace image](https://kal.wordpress.org/plugins/tags/replace-image/) [webp](https://kal.wordpress.org/plugins/tags/webp/) * [Advanced View](https://kal.wordpress.org/plugins/webangon-image-optimizer/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/webangon-image-optimizer/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/webangon-image-optimizer/reviews/) ## Contributors * [ webangon ](https://profiles.wordpress.org/webangon/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/webangon-image-optimizer/)