MediaRef Cleanup Auditor
MediaRef Cleanup Auditor analyses attachment records, content, metadata, and the uploads filesystem using durable, bounded jobs. It includes exact duplicate hashing, thumbnail analysis, optional live verification, quarantine and restoration, builder and plugin capability reporting, REST workers, and
MediaRef Cleanup Auditor analyses attachment records, content, metadata, and the uploads filesystem using durable, bounded jobs. It includes exact duplicate hashing, thumbnail analysis, optional live verification, quarantine and restoration, builder and plugin capability reporting, REST workers, and WP-CLI.
There is no paid edition, scan limit, license server, advertising gate or required external service. All processing occurs on the WordPress installation. Donations may support development but do not change functionality.
Safety language is deliberate: “No reference detected” is not proof that an item is unused. Dynamic code, remote consumers and unsupported data stores can create blind spots. Every cleanup attempt performs a fresh targeted reference check and verifies file identity.
Built for large and old media libraries
Scans use database-backed jobs, keyset cursors, adaptive bounded batches, staged publishing, and expiring worker locks. A browser refresh does not erase progress, and the same job can be resumed with WP-CLI. The Storage Explorer groups files by year, month, MIME type, attachment ownership, and derivative type, making sites with upload folders spanning many years easier to review.
Included without feature locks
- Media Library, metadata, options, builder, and filesystem reference analysis.
- Durable uploads manifest with missing, unknown, generated, and orphan-file classification.
- Exact duplicate groups using file size, MIME type, and SHA-256 fingerprints.
- Thumbnail inventory, missing-size analysis, selective cleanup review, and reporting.
- Optional same-origin live-page verification, disabled by default.
- Storage Explorer and Large Image Analyzer with date, folder, dimension, and size filters.
- Protected and ignored media states.
- Identity-checked private quarantine, restoration, and separate permanent deletion.
- REST dashboard workers and the complete wp mediaref-cleanup-auditor WP-CLI command set.
- Individual scanner classes for supported builders, galleries, commerce, LMS, membership, multilingual, cache, and custom-field ecosystems.