Description
Free up disk space without breaking your site.
Most sites keep hundreds of images nobody sees: photos removed from posts, old theme images, test uploads. Quilio Media Cleaner finds them, and cleans them up in a way you can undo.
Built around one rule: never lose a file that is used
- Looks everywhere. Post content, blocks and shortcodes, featured images, galleries, custom fields (ACF and others), page builders that store layouts as JSON (Elementor, Bricks, Beaver Builder…), WooCommerce products and categories, widgets, site icon and logo, Customizer settings, term descriptions, comments, user profiles, tables of other plugins (sliders, forms) and the files of your theme.
- Understands URLs. Image sizes (
-300x200),-scaledoriginals, WebP copies made by WordPress, relative URLs, CDN hosts and URLs escaped in JSON all count as uses of the right file. - Says when it is not sure. A number in a field named like an id (
related_id) may point to a file or not: such files are listed as possibly used, apart from the clearly unused ones. - Quarantine, not delete. Files are moved to a protected folder and hidden from the Media Library. Browse your site, and restore anything in one click. Delete permanently only from the quarantine, when you are sure.
- Checks again right before moving. Content written after the scan is searched once more; files mentioned anywhere stay where they are.
- Never touches shared files. Files used by another Media Library item (translations of WPML or Polylang, duplicated posts) are not moved or deleted.
- Recent uploads are safe. Files uploaded in the last 7 days (you choose) are never suggested: they may be waiting for a draft.
- Cloud storage aware. When media are offloaded to S3 or other cloud storage by a known plugin, nothing is moved.
- Runs on your server. No account, no cloud scan, no tracking. The scan runs in the background in small steps, so even large sites stay fast.
- Quiet. No dashboard ads, no nagging banners.
Free features
- Full scan of the site with progress, in the background.
- Lists: unused, possibly used, used, kept, recent uploads, missing files (in the Media Library but not on the server).
- “Used in” for every file: the posts, fields and settings that use it, with links.
- Filter by type (images, videos, audio, documents), search, sort by size or date, select all.
- Move to the quarantine, restore, delete permanently, empty the quarantine — one file or thousands.
- Keep files you want to keep forever; exclude paths (“logo”, “2019/”).
- Site Health test for missing files.
- WP-CLI:
wp quilio-mc scan,status,list,quarantine,restore. - Editors can be allowed to use it; settings stay with administrators.
Pro features
Quilio Media Cleaner Pro adds:
- Files on disk that are not in the Media Library: thumbnails of deleted images, failed uploads, files copied by FTP. WebP/AVIF and retina copies of library images are recognized and kept.
- Duplicates: the same file uploaded several times. Keep one; posts, featured images and galleries switch to it, and the copies become unused.
- Leftover image sizes of themes and plugins you no longer use.
- Scheduled scans (daily, weekly, monthly), an e-mail when new unused files appear, and automatic emptying of the quarantine after a number of days.
- CSV export of any list.
External services
The free version makes no requests to other sites.
Freemius (https://freemius.com) handles purchases and licenses of Quilio Media Cleaner Pro. The free version does not contact Freemius on its own: there is no opt-in screen and no usage tracking. Freemius is contacted only when you open the Pro pricing page, buy Pro or activate a license key. Then the data needed for the license is sent: site address, WordPress and plugin versions, the license key and the email address you enter. Terms: https://freemius.com/terms/ · Privacy policy: https://freemius.com/privacy/
Source code
The admin interface is built from the React sources included in the plugin (assets/src) with @wordpress/scripts. To rebuild the scripts in build, run npm ci and npm run build in the plugin folder (package.json and babel.config.js are included).
Third-party libraries
- Action Scheduler by Automattic (GPLv3), https://actionscheduler.org/ — background processing.
- Freemius WordPress SDK (GPLv3), https://github.com/Freemius/wordpress-sdk — licensing of the Pro version.
Screenshots





Installation
- Install and activate the plugin.
- Go to Media Cleaner and click Start scan.
- Review the unused files, move them to the quarantine, check your site, then delete them for good.
Make a backup of your site before deleting files permanently.
FAQ
-
Can it delete an image that my site uses?
-
The plugin is built so that this does not happen: it reads every place WordPress and common plugins store references, and when in doubt it marks a file as “possibly used” instead of “unused”. Files are first moved to the quarantine, where they can be restored with one click, and permanent deletion happens only from there. Still, no tool can know every plugin: browse your site after moving files, and keep a backup.
-
What happens to files in the quarantine?
-
They are moved to a folder inside uploads with a random name, protected against web access, and hidden from the Media Library. Their Media Library entries, titles, alt texts and metadata stay unchanged, so restoring brings everything back exactly as it was.
-
What happens when I deactivate or delete the plugin?
-
Deactivating keeps everything as it is (the quarantine too). Deleting the plugin first restores every file in the quarantine, then removes the plugin’s data.
-
My page builder or slider is not detected.
-
Layouts stored as JSON or serialized arrays, in post meta or in the plugin’s own tables, are read automatically. If a file still shows as unused although it is used, mark it as “Keep”, add its path to the exclusions, and tell us in the support forum which plugin it was.
-
Why is a file “possibly used”?
-
A field somewhere holds a number equal to the id of the file, and the field name suggests an id. It may be a real reference, or a coincidence (a user id, an order id). “Why possibly?” shows where it was found.
-
Does it work with WP Offload Media and other cloud storage?
-
When a known offload plugin is active, the lists are shown for review, but nothing is moved: the files on your server may be only a copy.
-
Does it work on multisite?
-
Yes, each site of a network is scanned and cleaned on its own.
-
Is anything loaded on the front end?
-
No. The plugin only runs in the admin and in background jobs.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Quilio Media Cleaner – Remove Unused Media Safely” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Quilio Media Cleaner – Remove Unused Media Safely” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.3
- Fixed: the “See plans” button could open a “page not found” screen. It now opens the Pro checkout in a new tab.
0.1.2
- Requires WordPress 6.9 (Action Scheduler 4.2).
- Plugin language can be chosen for each user. Pro includes translations into 10 languages.
0.1.1
- The message after moving or restoring files says why a file stayed where it was.
- A failed move leaves no empty folder in the quarantine.
0.1.0
- First release.
