README

A Magento 2 CLI module to find and delete unused product images from the filesystem and database. This helps free up storage space and keep your product catalog media clean.

🧩 Features

Adds a custom CLI command: catalog:images:delete:unused
Deletes product images that are no longer associated with any product
Optional --limit parameter to control how many images are removed per run

📦 Installation

Using Composer (recommended for Packagist users)

composer require darshiltech/magento2-product-image-cleaner

Then, run Magento's setup commands:

php bin/magento module:enable DarshilTech_ImageCleaner
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

⚙️ Usage

Run the CLI command to delete unused product images:

php bin/magento catalog:images:delete:unused

Optional: You can limit the number of images deleted in a single run:

php bin/magento catalog:images:delete:unused --limit=100

Default limit: 500

🗂️ Command Reference

Command	Description
`catalog:images:delete:unused`	Deletes unused product images
`--limit=500`	Optional limit of images to delete per run

🧠 Requirements

Magento 2.3 or higher
PHP 7.3 or higher (compatible with Magento version)

🧑‍💻 Author

DarshilTech
GitHub: github.com/DarshilTech

darshiltech / magento2-product-image-cleaner

Maintainers

Details