Elevoire Media Cleaner

Elevoire Media Cleaner helps WordPress administrators understand what is in their media library and why certain files might be consuming unnecessary storage.

The plugin analyzes your media library and clearly reports:

• Media files that do not appear to be referenced anywhere
• Duplicate files detected by content hash
• Oversized files that may be affecting site performance
• Missing files (records in the database where the physical file no longer exists)
• Total storage consumption broken down by file type

The core philosophy is: Analyze first. Explain clearly. Never make destructive changes unexpectedly.

The plugin is entirely read-only. It does not delete files, modify posts, or change any content on your site. You remain in control of every decision.

Free Features

Media Library Audit
Scan your full media library and collect detailed information about every attachment: file name, type, size, dimensions, upload date, and usage status.

Unused Media Detection
Detect media files that do not appear to be referenced by any content. The scanner checks post content, featured images, site options, post/page meta, nav menus, and Gutenberg block data. Results are classified as:

• In Use — references detected
• Likely Unused — no supported references found
• Possibly Used — uncertain

Files marked as “Likely Unused” should always be reviewed before taking any action. A file can be used by theme code, custom plugins, CSS, JavaScript, or external systems that this scanner cannot detect.

Duplicate File Detection
Find files with identical content using a file hash comparison. Duplicates are grouped so you can compare them and decide which copies to keep.

Large File Detection
Flag media files that exceed a configurable size threshold (1 MB, 2 MB, 5 MB, or 10 MB). Large images receive a recommendation to compress or replace them.

Media Statistics Dashboard
See a clean overview of your library: total file count, total storage, file type breakdown, and counts for unused, duplicate, and large files.

Media Audit Table
A searchable, filterable, and sortable table of all scanned media. Filter by type, usage status, or size. Sort by name, size, date, or type. Paginated to handle large libraries.

Detailed Media Information
Click any file to see a detailed audit panel: file info, dimensions, upload date, detected usage signals, and the reason the file was flagged.

Recommendations
Plain-language, informative recommendations for each flagged file. Recommendations explain what was found and why — never aggressive or alarmist.

Batched Scanning
The scanner processes your media in batches of 25 to avoid PHP timeouts and server overload. You can pause, resume, and cancel scans at any time.

Accuracy Notice

Media Cleaner identifies files that do not appear to be referenced by the content and data it can safely analyze. A file marked as “Likely unused” may still be used by a theme, plugin, custom code, external system, CSS, JavaScript, or another mechanism that this scanner cannot detect. Always review findings carefully before taking any action.

Privacy

This plugin collects no analytics, sends no data to external servers, and makes no external HTTP requests. All scanning happens entirely on your own WordPress installation. No account, license key, or registration is required.

Pro — Coming Soon

The free plugin is a complete, standalone media auditing tool. A future Pro version is planned to add:

• Safe media deletion workflow with review and confirmation
• Trash and recovery workflow
• Advanced unused-media detection across more content types
• WooCommerce product image usage detection
• Theme and plugin asset usage detection
• CSS and JavaScript reference analysis
• Backup integration before any cleanup action
• Scheduled media scans
• Advanced duplicate detection with visual similarity
• Bulk review and cleanup tools
• Detailed cleanup history and audit log
• Exportable media audit reports
• Priority support

These features are planned and not yet available. Nothing in the free plugin is intentionally withheld — the free version is a fully functional media audit tool.