Media Cleaner

Description

Clean your Media Library from the media which aren’t used in any of your posts, gallery and so on. It features an internal trash, moving the files in there temporarily for you to make sure the files aren’t actually in used; once checked, you can trash them permanently. Before using this plugin, make sure you have a proper backup of your files and database. This is the most important step on the usage of this plugin as you can’t trust any file deletion tools. The Pro version of this plugin brings scanning to the /uploads folder and will detect which files aren’t registered in the Media Library, not used in your content and so on. Retina images are also detected and supported, shortcodes, HTML in sidebars and of course your posts, pages and all post types.

A tutorial is available on the official website, here: Media Cleaner.

This tool is a knife. Do not use it if you don’t have any backup, or if you don’t know what it does. For backup, I recommend use the excellent service called BlogVault.

SPECIAL PLUGIN. Such a plugin is difficult to create and to maintain. If you understand WordPress, you probably know why. This plugin does its best to help you. Learn how to use it and you will get awesome results.

DASHBOARD. The files detected as not used will be listed in a specific dashboard. At this point, it will be up to you to delete them. They will be then moved to a trash internal to the plugin. After more testing, you can trash them permanently.

PRO. Media Cleaner Pro can scan your physical /uploads directory, and match it against the Media Library. It also has extra support for Page Builders.

COMPATIBILITY. I am adding support for specific plugins little by little. Currently, I have been working with ACF, Gutenberg, Divi, Fusion Builder (Avada), WooCommerce, Visual Composer (WPBakery), Elementor, and Beaver Builder. Specific checks for Page Builders are being added to the Pro version (as it requires meticulous work and updates).

AGAIN, BE CAREFUL. Again, this plugin deletes files so be careful! Backup is not only important, it is necessary. Don’t use this plugin if you don’t understand how WordPress works.

Screenshots

  • Media -> Media Cleaner

Installation

  1. Upload media-file-cleaner to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go in the Settings -> Media Cleaner and check the appropriate options
  4. Go in Media -> Media Cleaner

FAQ

The official FAQ is here.

Reviews

Using Media Cleaner

This plugin deleted also for some reason a lot of images that were used in post.
I was not able to understand why some images were or weren’t deleted.
I was happy to free some space and get rid of a lot of unnecessary images, but I won’t use it again, because i don’t trust it.

Filip

Works. but isn’t the quickest – Had to delete individually.

Unfortunately the remove-all feature didn’t work for me (Had to individually go through 500+ images – Updraft backup helped me restore the site! Like the warning says MAKE SURE YOU BACKUP! – Improvements – Needs to be able to be able to work with some popular plugins to check that images are not being used on the website. But seems to work fairly well with a large portion of plugins already. Can’t give a 5* review for this reason, but keep working at it!

Great plugin!

This plugin helped me to get rit of 5000+ images on a nice way.
Normal bulk delete made the server freeze. This plugin deletes a few images at the same time without any problems! Thank you!

Killer tool, Must have

This is an absolute no brainer to use. I’m currently using the pro version. It work very well although it needs good tweaking. The Pro version digs deep and if not correctly tuned you could lose some media. Good thing is The tool comes with a Trash bin so you’re able to recover anything before deleting permanently.

It keeps my media library updated and clean.

It is a smart tool and easy to use. I use it together with media file renamer another five star champion.

It runs fast and doesn’t take a lot of server resources.

I use it on every new site I create, and run it regularly on every running site.

I think Jordy provides one of the best support on WordPress plugins and that puts these plugins in a five star category.

Read all 141 reviews

Contributors & Developers

“Media Cleaner” is open source software. The following people have contributed to this plugin.

Contributors

“Media Cleaner” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Media Cleaner” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

5.1.0

  • Add: Filters for Filesystem scan. Please have a look at the tutorial (https://meowapps.com/media-cleaner-tutorial/), there is now a section about those filters.
  • Fix: Query for metakey.
  • Fix: Thumbnails matching.
  • Update: Compatibility for WordPress 5 and Gutenberg.

5.0.2

  • Update: Remove UpdraftPlus.
  • Update: Slight code cleaning.
  • Update: Checkboxes are updated dynamically.
  • Info: Media Cleaner is better than ever by going through so many improvements and optimizations this year. The plugin has also been perfectly stable for a few weeks, so I have decided to change its version number. Please help this plugin survive by giving me a nice review, here: https://wordpress.org/support/plugin/meow-lightbox/reviews/?rate=5#new-post. Thank you πŸ™‚

4.8.4

  • Fix: Issue with ACF Repeater.
  • Fix: Trash and Ignore features resulted in a weird behavior when used together.
  • Add: Now can delete the results of a search.
  • Update: Many UI improvements.

4.8.0

  • Update: Many parts of the UI were rewritten for a better experience. Buttons have a nicer logic.
  • Add: Enhanced error control. From now, when an error occurs during the scan, a popup will appear (asking to try again, or to skip the current item), and errors will be logged to the console.

4.6.3

  • Add: Added an option to only scan the thumbnails and ignore the base files.
  • Add: ACF Repeater support.
  • Update: Improved the code and the performance. Scan is now done differently, using the DB.
  • Fix: Debug logs weren’t logging (and enhanced them a bit).

4.5.5

  • Fix: Doesn’t remove the Media entry if the files cannot be deleted.
  • Update: Displays a warning if the log file cannot be created.

4.5.4

  • Update: Streamlined the plugin, tutorial has also been rewritten.
  • Update: Simplified the Settings. Removed the Gallery option, as it is part of the Posts or Post Meta.
  • Update: Support for UTF8, Background CSS, and Shortcodes have been moved to the Free version, and are now always enabled. Easier for everyone.
  • Add: Extra support for Page Builders is being added into the Pro version.

4.5.0

  • Add: Support for WooCommerce Short Description.
  • Add: Support for Divi Background.
  • Add: Support for Custom Fields Pro (ACF gallery).
  • Fix: Better support for CSS background.
  • Fix: Avoid detected file to be re-added if already there.
  • Update: Removed UTF-8 option (became useless).

4.4.7

  • Fix: Divi Single Image wasn’t always properly detected.
  • Add: Option for CSS background.
  • Update: Code cleaning, slighlty faster now.
  • Info: This plugin is hard work, don’t hesitate to review it πŸ™‚ Thank you.

4.4.6

  • Update: Support for ACF (Image Field as Object, URL and ID).
  • Info: This plugin is hard work, don’t hesitate to review it πŸ™‚ Thank you.

4.4.4

  • Update: Check DIVI Galleries and Single Images in Beaver Builder.
  • Update: Support for files which aren’t images and links (href’s).

4.4.2

  • Fix: Too many files were detected as used if WooCommerce was installed.

4.4.0

  • Info: This is a MAJOR UPDATE both in term of optimization and detection. Keep my motivation up and give a good review to the plugin here: https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post. That helps me a lot.
  • Update: Meta Data analysis is now cached, so much faster.
  • Update: URL detections became a bit more safer.
  • Update: Detect the images used by the themes more than before.
  • Fix: Images in widgets weren’t detected in many cases.

4.2.5

  • Update: Support for WP 4.9.
  • Fix: Could not empty trash if Media was already removed.

4.2.3

  • Fix: Meta search issue.
  • Fix: SQL typo for WooCommerce detection.
  • Fix: Avoid checking the empty arrays.

4.2.0

  • Info: This is a MAJOR UPDATE both in term of optimization and detection. Keep my motivation up and give a good review to the plugin here: https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post. That helps me a lot.
  • Add: Support for Fusion Builder (Avada).
  • Add: Cache the results found in posts to analyze them much faster later.
  • Add: Debugging log file (option).

4.1.0

  • Add: Support for WooCommerce Gallery.
  • Add: Support for Visual Composer (Single Image and Gallery).

4.0.7

  • Update: Bulk analyze/prepare galleries, avoid the first request to time out.
  • Add: Many option to make the processing faster or slower depending on the server.
  • Fix: Handle server timeout.
  • Add: Pause button and Retry button.

4.0.4

  • Update: Safest default values.

4.0.2

  • Add: Information about how a certain media is used (Edit Media screen).
  • Fix: Check / Create DB process.
  • Fix: Plugin was not working well with themes using Background/Header.
  • Update: A bit of cleaning.

4.0.0

  • Update: Core was re-organized and cleaned. Ready for nice updates.

3.7.0

  • Fix: Little issue when inserting the serial key for the first time.
  • Update: Compliance with the WordPress.org rules, new licensing system.
  • Update: Moved assets.
  • Info: There will be an important warning showing up during this update. It is an important annoucement.

3.6.4

  • Fix: Plugin was not working properly with broken Media metadata. It now handles it properly.
  • Info: If you want to give me a bit of motivation, write a review on https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post.

3.6.2

  • Fix: When over 1 GO, was displaying a lower size value.
  • Fix: Counting wasn’t exact with a Filesystem scan.
  • Info: Please read the previous changelog as it didn’t appear in WP for some reason.
  • Add: Check Posts also look for the Media ID in the classes (more secure).
  • Info: If you want to give me a bit of motivation, write a review on https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post.

3.6.0

  • Add: Now the Media can be recovered! You can remove your Media through the plugin, make sure they are not in use (by testing your website thoroughly) and later delete them definitely from the trash. I think you will find it awesome.
  • Update: Nicer internal icons rather than the old images for the UI.
  • Update: Faster and safer for post_content checks.
  • Update: This is a big one. The plugin is more clear about what it does. You need to choose either to scan the Media or the Filesystem, and also against what exactly. There has also been a few fixes and it will work on more big installs. If it fails, you can remove a few scanning options, and I will continue to work on making it perfect to support huge installs with all the options on.

3.2.8

  • Update: Show a better edit media screen.
  • Update: Will show the same number of items as in the Media Library (before it was fixed to 15 items per page).
  • Fix: Was displaying warning if the number of items per page in the Media page is not set.

3.2.0

  • Fix: HTML adapted to WP 4.5.1.
  • Fix: Doesn’t break if there is an error on the server-side. Display an alert and continue.
  • Update: Can select more than one file for non-Pro.
  • Fix: Issue with PHP 7.

3.0.0

  • Add: Option for resolving shortcode during analysis.
  • Update: French translation. Big thanks to Guillaume (and also for all his testing!).
  • Info: New name, fresh start. This plugin changed completely since it very first release πŸ™‚

2.5.0

  • Add: Delete the unused directories.
  • Add: Doesn’t break when there are too many files in the system.
  • Add: Pro version with better support.
  • Update: Improved detection of unused files.
  • Fix: UTF8 filenames skipped by default but can be scanned through an option.
  • Fix: Really many fixes πŸ™‚
  • Info: Contact me if you have been using the plugin for a long time and love it.

2.4.2

  • Add: Inclusion of gallery post format images.
  • Fix: Better gallery URL matching.
  • Info: Thanks to syntax53 for those improvements via GitHub (https://github.com/tigroumeow/media-file-cleaner/pull/3). Please review Media Cleaner if you like it. The plugin needs reviews to live. Thank you πŸ™‚ (https://wordpress.org/support/view/plugin-reviews/media-file-cleaner)

2.4.0

  • Fix: Cross site scripting vulnerability fixes.
  • Change: Many enhancements and fixes made by Matt (http://www.twistedtek.net/). Please thanks him πŸ™‚
  • Info: Please perform a “Reset” in the plugin dashboard after installing this new version.

2.2.6

  • Fix: Scan for multisite.
  • Change: options are now all enabled by default.
  • Fix: DB issue avoided trashed files from being deleted permanently.

2.0.2

  • Works with WP 4.
  • Gallery support.
  • Fix: IGNORE function was… ignored by the scanning process.

1.9.0

  • Add: thumbnails.
  • Add: IGNORE function.
  • Change: cosmetic changes.
  • Add: now detects the custom header and custom background.
  • Change: the CSS was updated to fit the new Admin theme.

1.7.0

  • Change: the MEDIA files are now going to the trash but the MEDIA reference in the DB is still removed permanently.
  • Stable release.
  • Change: Readme.txt.

1.4.0

  • Add: check the meta properties.
  • Add: check the ‘featured image’ properties.
  • Fix: keep the trash information when a new scan is started.
  • Fix: remove the DB on uninstall, not on desactivate.

1.2.2

  • Add: progress %.
  • Fix: issues with apostrophes in filenames.
  • Change: UI cleaning.

1.2.0

  • Add: options (scan files / scan media).
  • Fix: mkdir issues.
  • Change: operations are buffered by 5 (faster).

0.1.0

  • First release.