Description
Wisnoob Media Cleanup scans your whole site to work out which media files are actually used, and where. Instead of a bare “unused” label, every file shows the pages, products, widgets and settings that reference it, with a Find on page button that opens the page, scrolls to the image and highlights it.
Please back up your site before deleting anything. Deleted files cannot be recovered.
What it scans
- Post, page and product content and excerpts (any post type), including block attributes,
wp-image-123classes and gallery shortcodes - Featured images and WooCommerce product galleries
- Custom fields, including ACF image and gallery fields
- Elementor page data
- WooCommerce product category thumbnails and other term images
- Widgets (classic and block), menus, Customizer settings, site logo and site icon
- Block theme templates, template parts and global styles
- Additional CSS
- User profile images
Safety first
- Scans run in small steps, so large libraries never time out, and deleting stays disabled until a scan has fully finished.
- Files the scan found in use are never deleted by “Delete All Unused”.
- Right before deleting, Wisnoob Media Cleanup re-checks content edited since the scan, so an image you just added to a page is skipped.
- Every delete asks for confirmation.
Duplicate finder
The Duplicates tab finds:
- Exact duplicates: byte-identical files uploaded more than once
- Scale variants:
icon.png,icon@2x.png,icon-3x.png - Visual duplicates: the same picture in a different size, format or with small edits
Each file shows whether it is used, so you can keep the one your pages rely on.
Wisnoob Media Cleanup Pro
Want an undo? Wisnoob Media Cleanup Pro is an optional paid add-on:
- Quarantine instead of permanent delete: removed files are kept for 30 days and can be restored with one click.
- Merge duplicates: keep one copy and every page, featured image and gallery that used the others is updated automatically.
Everything described above works without it.
What it can’t see
Files referenced only from theme or plugin PHP code, hard-coded in theme CSS files, or linked from other websites are not detected. Check the “Find on page” result before deleting anything you are unsure about.
Screenshots




Installation
- Upload the plugin to
/wp-content/plugins/wisnoob-media-cleanup/, or install it from Plugins Add New. - Activate it.
- Go to Media Wisnoob Media Cleanup and click Scan Media Library.
FAQ
-
Is it safe?
-
Wisnoob Media Cleanup only deletes files you select, after confirming, and only after a complete scan. It cannot see every possible reference (see “What it can’t see”), so always keep a backup.
-
Does it work with page builders?
-
Elementor is scanned directly. Gutenberg, Classic Editor, WPBakery and Divi content is read from the post content, which covers image URLs and the image IDs those builders store.
-
Will it slow down my site?
-
No. Scanning only happens when you click Scan in the admin. Nothing runs on the front end except the “Find on page” highlighter, and only for logged-in administrators who opened a page from Wisnoob Media Cleanup.
-
What happens to my data if I uninstall?
-
Uninstalling removes Wisnoob Media Cleanup’s own table and settings. Your media files are not touched.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Wisnoob Media Cleanup” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Wisnoob Media Cleanup” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Scans now run in resumable steps with real progress, so large sites no longer time out.
- Deleting is disabled until a scan fully completes, and files found in use are skipped unless you confirm.
- Re-checks content edited since the scan right before deleting.
- Detects images referenced by ID: gallery shortcodes, image/gallery/cover blocks, ACF galleries, WPBakery, block-theme site logo, WooCommerce category thumbnails and placeholder.
- Scans product short descriptions, templates, template parts, global styles, term meta and user meta.
- Duplicate scan runs in steps and caches file hashes.
- “Space recoverable” now includes thumbnails.
- Summary figures load correctly when returning to the page.
- Selections reset when switching tabs, filters or searching, so hidden files can’t be deleted by accident.
- Escape closes the details window; all interface text is translatable.
- Works on PHP 7.4.
1.0
- Initial release.
