Image cleaner module for OpenMage (and Magento 1.9)

1.1.0 2023-09-23 23:34 UTC

This package is auto-updated.

Last update: 2024-03-23 16:32:25 UTC


If you find my work valuable, please consider sponsoring
Sponsor me on GitHub Buy me a coffee Donate via PayPal


  • Identify and remove orphan category images (reading data from the default "image" attribute and all custom attributes of type "image").
  • Identify and remove orphan product images (reading data from media_gallery) and product images cache.
  • Identify and remove orphan WYSIWYG images and files (reading used images/files from cms_block, cms_page, core_email_template tables and all /skin/frontend CSS files).
  • Check before delete: you can review (and download) the identified images before removing them.
  • Possibility to blacklist folders and/or files (with wildcard support) not to ever identify them as orphans.
  • Possibility to flush media/import, media/tmp, var/export, var/importexport.
  • Compatible with Magento 1.9, OpenMage 19 and OpenMage 20 on PHP >= 7.4.

How to use it

  • Install via composer (composer require fballiano/openmage-image-cleaner), modman (modman clone https://github.com/fballiano/openmage-image-cleaner) or any other way you like
  • Navigate to backend's "System -> Tools -> Image Cleaner" section
  • Click "Sync category images" and/or "Sync product images" or "Sync WYSIWYG"
  • The grid will show all the images that are detected as orphans
  • Delete them (check the backup section!) one by one or with a mass action

If you want to change the default thumbnail size (in the image cleaner admin grid) go to "System -> Configuration -> Advanced -> Admin -> Image Cleaner".

If you want to blacklist folders or files go to "System -> Configuration -> Advanced -> Admin -> Image Cleaner".


Backup your database and files before launching the cleaning process!!! This module is provided "as is" and I'll not be responsible for any data damage.


If you have any issues with this extension, open an issue on GitHub.


Any contributions are highly appreciated. The best way to contribute code is to open a pull request on GitHub.


Fabrizio Balliano


OSL - Open Software Licence 3.0


(c) Fabrizio Balliano