Oli Media Cleaner

Oli Media Cleaner scans your entire WordPress site to find media files that are no longer in use. It performs a deep analysis across multiple sources to accurately determine which files are safe to remove.

What Gets Scanned

• Post & page content — all post types, Gutenberg blocks, classic editor
• Featured images — all post types including WooCommerce product variations
• Custom fields (post meta) — any plugin or theme that stores attachment IDs or URLs
• ACF (Advanced Custom Fields) — image, file, gallery, repeater, flexible content, group, clone fields, and Options pages
• WooCommerce — product galleries, variation images
• Elementor — page builder widget data
• Theme files — PHP, CSS, JS templates scanned for hardcoded image references
• CSS background images — inline styles in post content
• Widgets — image, gallery, text, custom HTML widgets
• Site identity — site logo, site icon, theme mods
• Serialized data — deep scan of complex plugin data structures

Features

• Batch scanning — processes 50 attachments per batch to avoid timeouts
• Whitelist — protect files you want to keep even if unused
• Bulk actions — trash, whitelist, restore, or permanently delete multiple files at once
• Trash All — one-click batch trash of all unused images with progress bar (handles thousands)
• Scheduled auto-cleanup — enable daily, twice daily, or weekly automatic scan and trash via WP-Cron
• Progress bar — real-time scanning progress
• No external dependencies — uses native WordPress admin styles, no Bootstrap or jQuery UI
• Zero custom database tables — stores data in WordPress options
• Clean uninstall — removes all plugin data on deletion

How to Use

1. Go to Oli Media Cleaner under Media in the WordPress admin sidebar
2. Click Scan for Unused Media
3. Review the results in the Unused tab
4. Whitelist any files you want to keep
5. Trash files you don’t need
6. Go to the Trash tab to permanently delete or restore files