Powered by Adobe Commerce 2.4.5


Image Cleaning



Back to top

Many web-stores with long histories run into problems with the server's 'pub/media/' folder getting pumped up and taking up plenty of precious storage space. Tens, even hundreds of gigabytes of data that take more and more despite the number of goods remain stable.

Having examined the contents of the media folder, we concluded it contains all the uploaded images, including those unusable by Magento. Real heaps of rubbish!  We specially tested the process of removal of a product/category containing images as well as removal/editing of images under the product's 'Images And Videos'. It appeared Magento only removes records about the images, not their physical files. This becomes one of the major causes for the website to occupy more space and to slow down a system call for files and images due to the server's extreme file system load.

The extension we present allows you to thoroughly scan and safely clean the 'pub/media/' folder. The procedure that the extension performs is not intended to be run only once, else the media folder will start growing again. This is why we specifically added a programmable Cron job for the extension to scan the storage and automatically clean it once a week/month. Resources to clean are represented by the following options:

  • Image files that do not belong to any product
  • Image files that do not belong to any category
  • DB record related to a product's nonexisting image file
  • DB record related to a category's nonexisting image file

Based on the capabilities of your server, specify the One-Time Limit for cleaning to make sure your system doesn't hang for a long time. You can always make a manual clean run by hitting the 'Clean Now' button. Want to get more information on what has been removed? The detailed cleanup results are always logged in: /var/log/cleaned_images.log.



  • Safely cleans dead files in 'pub/media/' which may greatly reduce the folder's size
  • Matches physical file against its record in the DB
  • Removes product's and category's obsolete and unutilized images
  • Removes media's DB records relating to nonexisting image files of products and categories
  • Configurable Cron schedule for cleaning
  • Perform a cleanup using a CLI command image-cleaning:clean-images



Admin Demo

Technical Specifications

Back to top

Seller profile


Seller contact


Current Version


Adobe Commerce platform compatibility

Open Source (CE): 2.3 (current), 2.4 (current), 2.2 (obsolete)

Commerce on prem (EE): 2.3 (current), 2.4 (current)

Commerce on Cloud (ECE): 2.3 (current), 2.4 (current)


Stable Build


05 July, 2022


Extensions, Site Optimization

Quality Report

Back to top

Installation & Varnish Tests


Coding Standard


Plagiarism Check


Malware Check


Marketing Review


Manual Testing


All tests were conducted on the latest versions of Adobe Commerce that existed for the compatible release lines at the moment of the extension submission. Latest versions of all other software were used, as applicable.

Release Notes

Back to top


  • Compatible with Open Source (CE) : 2.3 2.4
  • Compatible with Commerce on prem (EE) : 2.3 2.4
  • Compatible with Commerce on Cloud (ECE) : 2.3 2.4
  • Stability: Stable Build
  • Description:

    • Added ability to run optimization using CLI;
    • Added support for Magento 2.4.x;
    • Improved support for Magento Commerce;
    • Added support for symlinks to media files;
    • Code refactoring.


  • Compatible with Open Source (CE) : 2.2 2.3 2.4
  • Stability: Stable Build
  • Description:

    • Added support for Magento 2.4.0.


  • Compatible with Open Source (CE) : 2.2 2.3
  • Stability: Stable Build
  • Description:

    • Addressed an issue with placeholders and watermarks.


  • Compatible with Open Source (CE) : 2.2 2.3
  • Stability: Stable Build
  • Description:

    • Added ability to ignore files from the 'cache' folder.


Back to top

The best place to start if you need help with a specific extension is to contact the developer. All Adobe Commerce developers have both a contact email and a support email listed.

Contact Vendor

Q & A

Back to top


Back to top