⚙️ Plugin Highlights
✅ Detects true unused media
Scans across native WordPress, Elementor, Gutenberg, WPBakery, ACF Pro, Avada, WooCommerce, and more.

✅ Shows exactly where files are used
Each used media item includes a reference link to the page, post, or field where it appears — including featured images, custom fields, backgrounds, CSS, and shortcodes.

✅ Safe & secure cleanup
Choose to move files to trash, export them as a ZIP before deletion, or permanently delete them in bulk. Includes a built-in Media Inspector for full transparency.

✅ Developer friendly

Built with clean, WordPress-compliant code

All SQL queries are sanitized and properly prepared

Fully supports WP-CLI for large or headless WordPress sites

✅ Smart scan options
Control scan depth, include/exclude revisions, and detect background images from Additional CSS or custom field values.

What It Does:
This plugin scans your entire WordPress site and detects which media files are actually used across:

✅ Native WordPress (Classic Editor)
✅ Gutenberg blocks
✅ Elementor (Free & Pro)
✅ WPBakery Page Builder
✅ Avada Website Builder / Fusion Builder
✅ ACF Pro (image fields, repeater, gallery, etc.)
✅ WooCommerce (product image + gallery)
✅ Custom fields, backgrounds, inline HTML, and more

Additional Features: 

Compatible with ACF Optional pages and Impreza theme++

🔎 Media Inspector

 - View detailed references of where each media file is being used (page/post ID, title, section like featured image, ACF, shortcode, etc.)
 - Helps you confidently identify truly unused files.

🧹 Smart Unused Media Detection
 - Scans post content, meta fields, builder data, CSS (including Additional CSS & theme options), shortcodes, and even custom fields.

💻 WP-CLI Support (perfect for large sites)
 - Run cleanup scans or exports directly from the command line.
 - Great for developers and sysadmins managing large media-heavy sites.

📦 Export Before Deleting
 - You can export selected unused media as a ZIP before deletion.
 - Offers peace of mind during bulk cleanups.

🗑️ Safe Delete or Move to Trash
 - Choose to move files to trash first or permanently delete them.
 - Restore trashed files easily if needed.

🔁 Pagination + Bulk Actions
 - Efficient even on media libraries with thousands of items.
 - Bulk select and clean with intuitive filters.

✔️ WordPress 6.5+
✔️ PHP 7.5+
✔️ Local / Production servers
✔️ Elementor, WPBakery, Divi, Avada, ACF Pro, WooCommerce and many more.

🔍 How to Run a Media Scan:

To scan your WordPress site for unused media:

✅ Step-by-Step:
1. Login to your WordPress Admin Dashboard
2. Navigate to: Tools → Unused Media Cleaner
3. Click the “Start Scan” button

📂 Scan Results – 3 Tabs Explained

Once the scan is complete, you’ll see your media organized into three tabs:

🧹 1. Unused
Lists media files not currently used on your site
You can:
 - Select multiple items
 - Move them to Trash, Permanently Delete, or
 - Use the Export option to back them up before deletion

✅ 2. Used
Displays all media files that are actively in use
Each image includes:
 - The reference page/post
 - The type of usage (e.g., featured image, ACF field, Elementor block)

🗑️ 3. Trashed
Shows all media that was previously trashed
From here, you can either:
- Permanently delete
- Or Restore any media back to the library

⚠️ Important Tips for Accurate Scans
🧼 Purge all cache (from your caching plugin or host) before running a scan
🧾 If your site uses Elementor or ACF Pro, be sure to check the box:
“Clean revisions before scan”
This helps prevent false positives caused by old content stored in post revisions.