Actively Maintained v1.5.5

M2clitools

tnegeli/m2clitools

Provides CLI commands to cleanup unused product, category, and swatches media files. Also removes illegal media gallery entries and fixes missing product image references.

63,010
Downloads
Below average
39
GitHub Stars
Below average
2mo ago
Last Release
5
Open Issues
Build Passing
Ready to install

Build Tests

Composer Install
DI Compile
Templates

Code Quality

CS Coding Standard
14 errors , 461 warnings
L0 PHPStan

Tested on Magento 2.4.8-p3

Recent Test History

Each release is tested against the latest Magento version at that time.

v1.5.5 on Magento 2.4.8-p3
Dec 26, 2025
GitHub Repository
Source code & docs
Packagist
Version history
Issues & Support
Get help or report bugs

Share This Module's Status

M2clitools Magento compatibility status badge

README

Loaded from GitHub

CLI Tools for Magento 2

Various CLI Tools for Magento 2

Available commands:

php bin/magento tnegeli:cleanup-unused-product-media

Use this command to backup (or delete) unused product media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-unused-category-media

Use this command to backup (or delete) unused category media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-unused-swatches-media

Use this command to backup (or delete) unused swatches media from filesystem.

You can use the --dry-run option to just test the result.

You can use the --delete option to remove files, instead of doing a backup.

php bin/magento tnegeli:cleanup-illegal-product-media

Use this command to identify and remove illegal entries in the media gallery database table, which might break catalog:images:resize process.

You can use the --dry-run option to just test the result and give you a list of value_id entries from the media gallery table which are illegal.

php bin/magento tnegeli:cleanup-illegal-product-media-non-existing-files

Use this command to identify and remove illegal entries in the media gallery database table that have no files on the filesystem, which might break catalog:images:resize process.

You can use the --dry-run option to just test the result and give you a list of value_id entries from the media gallery table which are illegal.

php bin/magento tnegeli:cleanup-illegal-product-image-markers-non-existing-files

Each product is checked for the attribute values of

  • image
  • small_image
  • thumbnail

If a product references a file that does not exist, the reference is removed.

You can use the --dry-run option to just test your database.

This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.

Back to All Modules