Janitorix Media Audit — an unused image cleaner that proves it first
Summary. Janitorix Media Audit finds the images in your WordPress media library that nothing uses — then shows its evidence before it suggests deleting anything. Every file gets two separate scores, one for confidence and one for risk, and the plugin only ever moves files to Trash. Free, no Pro version.
Deleting is cheap until it is wrong
Every media library fills up the same way: old banners, replaced logos, test uploads, the three spare photos from a post that used one. Leaving them costs a few kilobytes each. Deleting one that is still referenced — a Customizer background, an ACF field, a page-builder section — breaks a page you might not open for weeks.
Most cleanup tools treat those two mistakes as equal. They scan, they flag, they hand you a delete button. This plugin starts from the opposite end: the cost of being wrong is the whole design. That is why "is this used?" is never one answer here. It is two.
Two scores, not one guess
Each image is checked by scanners covering post content, Gutenberg blocks and synced patterns, full-site-editing templates, the Customizer, theme options, widgets, menus, Elementor, ACF, WooCommerce, and the theme's own PHP, CSS and JavaScript files. The result comes back as two judgements:
- Confidence — how sure the plugin is that the image is genuinely unused.
- Risk — how much damage deleting it would cause if the plugin is wrong.
A stray test upload and an unreferenced site logo can score identically on confidence and need opposite treatment. That is why risk is scored on its own, and why anything at medium risk or above is never offered for Trash at all.
What it refuses to do
- Will not recommend deleting anything if scan coverage was too low — it asks for a rescan instead
- Will never touch a site logo, icon or header — refused outright, not just scored low
- Will not touch anything uploaded in the last 24 hours — it may not have been placed yet
- Never deletes in one step — Trash first, always, so anything can be restored
For the terminal-inclined
The whole thing also runs from WP-CLI: scan the library, ask why one image got the verdict it did, preview exactly what would be deleted without deleting anything, and calibrate the engines against known answers. The read-only preview is the same evidence the admin screens show, in CSV form.
FAQ
- Does it delete images permanently?
- No. It only ever moves files to Trash, so anything can be restored. There is no one-click permanent delete.
- What if the plugin is wrong about an image?
- That is what the risk score is for. Anything at medium risk or above is never offered for Trash, however confident the scan is.
- Will it touch my logo or header image?
- No. The site logo, icon and header are refused outright, as is anything uploaded in the last 24 hours.
- Can I run a scan from WP-CLI?
- Yes. Scan, explain, preview deletions and calibrate — all from the command line.
- Is there a Pro version?
- No. Confidence and risk scoring, Trash-only cleanup and WP-CLI — everything is in the free plugin, reviewed by the WordPress.org team before release.
Understand first, or install first
If you want to understand the problem first — where a reference can hide and how to check one image by hand — that is the full guide. If you want the tool, it is one search away in your dashboard.
Download on WordPress.org Source on GitHub
