Unused Media Review
Find the media nothing on your site uses, review it with thumbnails and remove what you pick into an archive you can restore in one click.
- Unused Media Review
A Media Library fills up over the years with images from deleted posts, replaced logos, test uploads and files nobody remembers. They take space on the server and in every backup. Unused Media Review finds them by reading your posts, custom fields, settings and theme, shows you each one with its thumbnail, and lets you decide: keep it, or remove it into an archive you can restore. Every feature is free, with no upgrade to buy.
Features
- A thorough scanAn item counts as used when it is linked or inserted in a post, page or product, set as a featured image, part of a gallery or a WooCommerce product gallery, stored in a custom field (ACF and page builders included), used as a category image or user picture, set as site icon, logo or in a widget, or named in your theme files.
- Drafts and the trash countMedia used in drafts, scheduled posts and posts in the trash counts as used, so restoring a post never brings back a broken image.
- Review with thumbnailsEvery unused item is shown with its thumbnail, file name, type, size, upload date and the post it was attached to. Filter by images, video, audio and documents, search by name, and select a page or every result.
- Keep what you wantMark items as kept and later scans leave them out. The Kept screen lists them, and one click puts an item back into the review.
- Remove into an archiveRemoved items leave the Media Library, but their files and database rows are saved in an archive. Restore brings them back with the same ID, title, alt text and captions.
- Checked again before removalJust before an item is removed, posts changed since the scan and the site settings are read again. An item that is used by then is left alone and listed in the report.
- Delete for good only on purposeDeleting media straight away, or deleting an archive, needs DELETE typed in the dialog.
- Careful defaultsUploads from the last 7 days are skipped, since they may belong to a post still being written. You can also count media attached to a post as used, even when the post does not show it.
- Works on large sitesThe scan runs in short steps, so it never hits a PHP time limit, and a progress bar shows each step. It adds nothing to the front end and sends no data anywhere.
Screenshots
How to use
- Download the ZIP, then in WordPress go to Plugins > Add New Plugin > Upload Plugin, choose unused-media-review.zip, install and activate it.
- Open Media > Unused Media, go to Review and check the scan options.
- Click Scan for unused media. Nothing changes; you get a list of every item nothing on the site uses.
- Go through the list. Click Keep for anything you want to hold on to, select the rest and click Remove to archive.
- Browse your site for a few days. If something is missing, click Restore under Archive; if all is well, delete the archive to free the space.
FAQ
Is a scan safe to run on a live site?
Yes. A scan only reads. It changes no file and no database entry, apart from saving its own results.
How do I undo a removal?
Open Media > Unused Media > Archive and click Restore next to the removal. The items come back to the Media Library with their files, and with the same ID when it is still free.
Can a scan miss a use?
A plugin or theme can store media in a way no scan can know about, for example an ID computed in code. That is why removals go to an archive first. Browse your site for a few days after a removal, then delete the archive.
Why is an image I never use not listed?
Something points to it: a link, its file name, or its ID in a custom field or setting. Images added in the last 7 days and kept images are left out too.
Where are the archives, and what happens to them when I delete the plugin?
In wp-content/uploads/unused-media-review-backup/. They stay when you delete the plugin, because they hold your files. Delete them under Archive first, or remove the folder yourself.
Does it work with images on a CDN or cloud storage?
The scan works on the Media Library and your site's data. Removing an item moves the files that are in your uploads folder; copies on remote storage are handled by your offload plugin, if it reacts to deleted media.
Is it free?
Yes. Unused Media Review is free software under the GNU General Public License, version 2 or later, with every feature unlocked. You may use, change and share it under the terms of that license. If it saves you space, you can support its development with a coffee.
How do I get help?
Read the documentation, or reach us through the support page.
What's new
- 2.0.0(November 9, 2026)Rebuilt for every site: a full scan of posts, custom fields, term and user data, settings, widgets and theme files. A new screen under Media > Unused Media with Overview, Review, Kept and Archive; a review grid with thumbnails, filters, search and select all; kept items; removals go to an archive that restores with the same IDs; every item is checked again before removal; deleting for good needs DELETE typed. Now licensed under the GPL, version 2 or later.
- 1.0.0(October 8, 2026)First release, made for one site with a fixed list of items.