Media Cleaner Pro is now available on GPLShare as one of the image media file cleaner plugins for unused media files on your WordPress website.
As fellow WordPress site managers, we all know the problem that often gives us headaches: server storage filling up due to piles of unused images. When we delete articles, change themes, or swap out elements in Page Builders, WordPress always leaves behind “orphaned” files on the server, right?
Well… if you’re looking for a solution to this problem, you’ll definitely come across Media Cleaner Pro developed by Meow Apps. Let’s discuss this plugin in detail and see how it works.
What is Media Cleaner Pro
Media Cleaner Pro is an advanced plugin for detecting, quarantining, and deleting media files such as images, videos, and documents that are no longer used within your WordPress site, and it also repairs broken Media Library database entries.
Unlike regular database cleaner plugins, Media Cleaner Pro works at the intersection between database metadata entries and the physical directory structure of the server’s storage /wp-content/uploads/.
Scanning System (Dual-Scan Engine)
What makes this Pro version superior to the free version is the Dual-Scan Engine architecture.
This plugin divides cleaning tasks into two state-of-the-art methods as follows:
Media Library Cleaning (Database to Content) works by reading the wp_posts table (specifically the attachment type). It collects all media IDs, then crawls all active content such as articles, pages, custom post types, widgets, and even JSON code lines inside page builders to match whether those image URLs are actually called on the web pages. If there is no match, the media enters the “Issues” list.
Uploads Folder Cleaning (File System to Database) is an exclusive feature of the Pro version. The opposite of the first method, the Filesystem Walker will traverse the physical /wp-content/uploads/ folder recursively. It searches for actual image files on the server that are not registered at all in the WordPress Media Library (for example, leftover files from manual migrations or remnants of old plugins).
Complexity of Third-Party Parsers
The biggest challenge for media cleaner plugins is falsely detecting active images as unused or false positives, especially if images are called via Shortcodes, Custom Fields, or complex Page Builders.
With this Media Cleaner Pro version you can overcome this by integrating nearly 70 parsers for popular themes and plugins such as Elementor, Divi, Beaver Builder, WPBakery, WooCommerce, Advanced Custom Fields (ACF), and various types of sliders. These parsers are capable of reading serialized data or internal builder JSON encryption to ensure images within dynamic components are not accidentally deleted.
Media Cleaner: Security and Quarantine System
Meow Apps created this plugin with a Safe-by-Design approach. Here is how it works…, For example when you click the “Delete” button on the issues list the file does not just vanish completely from the server. Media Cleaner Pro moves it to a trash system. The actual file is moved to a quarantine folder and the database entry is temporarily not visible.
If after cleaning your site something goes wrong or images are missing you go to the Trash tab. Click one button to restore the files to where they were before.
Once your site is known to be safe, for a days you can then choose the right action by clicking the Empty Trash button to delete them completely.
Recommended Workflow
Since this is a plugin that interacts directly with your file server’s core, here is the mandatory SOP (Standard Operating Procedure) before running it:
1. Mandatory Full Backup
Create a full backup of the database and the /wp-content/uploads/ folder. We recommend testing it first in a Staging / Site Clone environment.
2. Disable Caching & Lazy Load
Temporarily disable caching plugins such as WP Rocket, Asset CleanUp, LiteSpeed Cache, and CDN/Lazy Load. Why? Because these optimization scripts often alter the original HTML structure from src to data-src, which can trick the plugin’s parser engine into treating active images as unused.
3. Use the “Ignored List” Feature
If you have certain folders or files belonging to custom code that must not be touched, register their patterns using Regex in the plugin’s settings menu.
4. Split into Small Batches / Use WP-CLI
If your site is large-scale for example having more than 10,000 media items, we recommend limiting the scan batch limit in the settings so the server doesn’t crash. If you’re an advanced VPS user, we recommend running this process via terminal using the WP-CLI command wp media-cleaner scan for performance stability.
