Media Cleanup Dashboard
Description
Highlights
About the Extension
Unused media files accumulate in every Shopware store over time — especially after product imports or layout changes. The built-in media:delete-unused CLI command is out of reach for most merchants and provides no visual feedback. Media Cleanup Dashboard solves this: a clear admin dashboard that safely identifies, displays, and deletes unused files — no command line access required.
Key Benefits
- No CLI access needed: Everything handled directly in the Shopware Administration.
- Safe: Confirmation dialog showing file count and total size before every deletion.
- Full control: Include media that only appears in old orders when you choose to — with a clear warning before deletion.
- No timeout: Async background scan handles large media libraries — results are cached for 4 hours so page navigation never triggers a re-scan.
Features in Detail
Clear Dashboard
The dashboard displays all unused media files in a paginated list — with preview thumbnail (or a file-type icon for PDFs, videos, etc.), file name, type, size, and upload date. A summary bar at the top shows the total file count and combined storage size at a glance.
Bulk Selection and Safe Deletion
Select individual files via checkbox or use "Select all" — even across multiple pages. Before any deletion, a confirmation dialog shows the number of files and total size. A progress indicator keeps you informed during deletion, and the result (deleted / skipped / failed) is reported in detail when complete.
Filters and Sorting
Filter the list by file type (image, video, document, other), minimum file size, or upload age. Sort by file name, file size, or date — ascending or descending. A single click resets all active filters.
Background Scan and Result Caching
The scan runs asynchronously in the background via Symfony Messenger — no HTTP timeout, even for very large media libraries. A real-time progress indicator shows the scan status while it runs. Results are cached for up to 4 hours: page navigation and delete operations do not trigger a full re-scan. A "Rescan" button refreshes results on demand. Before every deletion, the plugin also performs a last-mile verification — checking in real time whether a file has been re-assigned since the scan — so no actively used files are ever deleted.
Optional: Include Media Linked to Past Orders
Shopware stores the product image on every ordered item — even long after the product itself has been deleted. Such images never count as unused, so by default they do not appear in the list. With the "Also include media linked to orders" option right next to the scan button, you can also find files that are only still referenced by past orders. They are clearly labelled in the list and show how many orders they are linked to. Before deleting, the confirmation dialog warns that the image will no longer be displayed in those orders — the orders themselves remain untouched. The option is off by default.
User Permissions (ACL)
The plugin adds two separate privileges for viewing and deleting unused media. Staff can review the list without having delete access.
Technical Details
- Shopware compatibility: 6.6.x and 6.7.x
- PHP: 8.2+
- External services: None — the plugin communicates only with your own Shopware instance.
- Performance: Async background scan via Symfony Messenger prevents timeouts even for very large media libraries; results are cached for 4 hours.
- Standards-compliant: Uses Shopware's UnusedMediaSearchEvent — other plugins can mark their media as in use and those files will be respected.
Details
- Available: English, German
- Latest update: 2 November 2026
- Publication date: 2 April 2026
- Version: 2.3.0
- Category: Administration
Resources
Reviews (0)
About the Extension Partner
momocode
Partner Status
-
Shopware
Extension Partner
Details
- Ø-Rating: 5
- Partner since: 2019
- Extensions: 12
Support
- Based in: Germany
- Speaks: German, English
- Response time: Very quickly