Delete & Clean Unused Images for PrestaShop

Stop wasting server space on orphan images. Every deleted product, category, or CMS page leaves behind image files that are no longer used. Our module scans, identifies, and safely removes every orphan image — giving you a lighter, faster, and cleaner PrestaShop.

What Does This Module Do?

✓ Scans Product images (/img/p/) for orphans from deleted products
✓ Scans Category images (/img/c/) for leftover thumbnails
✓ Scans CMS/Upload images (/img/cms/) no longer referenced
✓ Compares files against your database, theme CSS, and module files
✓ Shows thumbnail preview before deletion
✓ Deletes safely with confirmation dialog

What's Included

✓ Main module class (opdeleteunusedimage.php)
✓ Admin controller for clean interface
✓ Cron execution file for automatic cleaning
✓ Database install/uninstall scripts
✓ SweetAlert2 for safe confirmations
✓ Comprehensive documentation

Language flags are automatically protected — fr.jpg, de.jpg, en.jpg are NEVER deleted!

One-Click Scan

Products, categories & CMS in one click

visibility

Preview Before Delete

Thumbnail preview of every image

shield

Blacklist System

Protect folders/files with wildcards

schedule

Cron Support

Automatic cleaning for large stores

image

Multi-Format Support

JPG, PNG, GIF, WebP, AVIF

delete_sweep

Bulk Delete

Delete multiple images with confirmation

cleaning_bucket

Flush TMP

One-click cleanup of img/tmp folder

refresh

Reset Counter

Restart fresh scan anytime

🚀 How It Works

Scan

Click Sync Product/Category/CMS

visibility

Preview

Review thumbnails before deletion

delete_forever

Delete

Free server space permanently

Technical Specifications

🛒 Platform Compatibility

✓ PrestaShop 1.6✓ PrestaShop 1.7✓ PrestaShop 8.x✓ PrestaShop 9.x

⚙️ Server Requirements

PHP Version	7.2 - 8.3	✓ Compatible
MySQL / MariaDB	5.7+ / 10.2+	✓ Compatible
Memory Limit	128MB minimum	256MB+ recommended
Disk Space	~1 MB (module files)	✓ Minimal

🖼️ Image Formats Supported

JPGJPEGPNGGIFWebPAVIF

💡 Pro tip: Each format can be enabled/disabled independently in module configuration.

Version History & Release Notes

Current stable version: v4.0.1

Version	Release Date	PrestaShop	Changes
v4.0.1	2024-07-23	1.6 - 9.x	AVIF support, PHP 8.3 compatibility, bug fixes
v4.0.0	2024-05-10	1.6 - 8.x	Major: WebP support, cron improvements, UI refresh
v3.2.0	2023-11-15	1.6 - 8.x	Orphaned images for inactive/deleted products option
v3.1.0	2023-08-20	1.6 - 8.x	PNG & GIF support added
v3.0.0	2023-05-01	1.6 - 8.x	Initial release with product/category/CMS scan

ℹ️ Customers with active license receive all updates automatically via PrestaShop backoffice.

Frequently Asked Questions

❓ Is it safe to delete unused images?

Yes — the module only identifies images NOT referenced in your database, theme CSS, or module files. You preview every image before deletion. The blacklist feature adds extra protection. Always backup before first use.

❓ Does it work with WebP and AVIF images?

Absolutely. You can enable/disable each format in configuration. When enabled, the module scans for orphan files of those formats alongside standard JPG, PNG, and GIF.

❓ Can I recover deleted images?

No — deletions are permanent using PHP's unlink(). Always review scan results carefully and keep regular server backups. The thumbnail preview helps prevent accidental deletions.

❓ Will this slow down my store during scan?

No. Scan runs in admin panel background and does not affect front-office. For 50,000+ images, initial scan takes 30-60 seconds. Use cron mode for low-traffic hours.

❓ How to handle large stores with 50k+ images?

Use the cron feature. Configure your server's cron job to call the unique cron URL daily. Set "cron_max" to control how many images are deleted per execution (default: 10).

❓ Does it work with multi-language stores?

Yes, perfectly. The module automatically protects all two-letter language flags (fr.jpg, de.jpg, en.jpg, es.jpg, etc.). Your multilingual images are fully supported.

❓ What is the blacklist feature?

The blacklist protects specific folders or files from ever being deleted. Use wildcards (e.g., "p/*/logo.jpg" or "watermark/"). One pattern per line.