Media Cleanup Dashboard

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.
• 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.

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.