Media Cleaner cleans your Media Library from the media entries (and files) which aren’t used in your website, as well as broken entries. An internal trash allows you to make sure everything works properly before deleting the media entries (and files) permanently. It uses a smart analysis powered by many implementations for specific plugins and themes.
Before using this plugin, make sure you have a proper backup of your install. This step is not optional; it is required. You cannot trust any tools modifying or deleting your files.
For compatibility, Pro version and important information, please read this until the end. Last but not least, it is necessary to read the tutorial. It is available on the official website, here: Media Cleaner.
This tool cuts like a knife. Do not use this plugin if you don’t have a recent backup, or if you don’t understand what it does. This plugin does its best to help you. Learn how to use it and you will get awesome results.
HOW IT WORKS
Any files detected as not used will be listed in a specific dashboard. It will be up to you to delete them. Then, they will be moved to the plugin’s internal trash on the plugin. After more testing, you can restore those files from the trash, or you can delete them permanently.
This plugin works with any kind of media entry, including retina and/or WebP versions. The plugin has been tested on modern WordPress installs (Gutenberg included) as well as many older versions. The plugin has also been tested on various themes along with a community of thousands of users. It does support WooCommerce. If you are using complex plugins to handle the content of your website, the Pro version might be required. I am constantly increasing compatibility with other plugins.
The Pro version adds Filesystem Analysis, extra support for complex plugins, Live Site option and WP-CLI support.
With the Filesystem Analysis, Media Cleaner Pro scans your physical /uploads directory, and match it against the Media Library. It also has extra support for complex plugins, such as:
- ACF (+ ACF Widgets)
- Divi Builder
- Fusion Builder (Avada)
- WPBakery Page Builder
- Visual Composer
- Beaver Builder
- Brizy Builder
- Oxygen Builder
- Slider Revolution
- Avia Framework
- And more (Theme X, ZipList Recipe, WP Residence, WCFM MarketPlace, UberMenu…)
The Live Site option will analyze the online version of your website, which might enhance the accuracy of the Cleaner in edge-cases.
Last but not least, Media Cleaner Pro has support for WP-CLI. If you have direct access (SSH) to your server, you will be able to run the plugin at a much higher speed or have it run automatically, if you’d like.
BE CAREFUL: PREPARE A BACKUP
Better to be safe than sorry. This plugin deletes files! Therefore, backup is not only important, it is required. Do not use this plugin if you are not ready. I can’t help you if you damage your media library permanently without a backup.
- Mike Meinz, an amazing developer from the US who made a thorough debugging of the whole process, loaded a lot of corrections and optimizations and added support for more plugins.
- Satoshi Soma, an excellent Japanese developer.
- To all the users who helped me with reproducing issues and testing new plugins and page builders.
- Upload the plugin to WordPress.
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to Meow Apps -> Cleaner in the sidebar and check the appropriate options.
- Go to Media -> Cleaner.