1. Description

Unused media files accumulate in every Shopware store over time — especially after product imports, layout changes, or manufacturer logo updates. While Shopware includes the media:delete-unused CLI command, most merchants don't have server access to run it.

Media Cleanup Dashboard brings this functionality directly into the Shopware Administration: a visual dashboard that safely identifies, displays, and deletes unused files — no command-line access required.

Dashboard overview with unused media files

Features at a Glance

Dashboard with File List

The dashboard displays all unused media files in a paginated list — with a 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 is displayed during deletion; the result (deleted / skipped / failed) is reported in detail when complete.

Confirmation dialog before deleting

Enhanced Detection

Shopware's core does not recognize preview images set on YouTube or Vimeo video CMS elements as "in use." Media Cleanup Dashboard closes this gap: preview images configured in video elements are correctly identified as used and will not appear in the deletion list — regardless of which page the video element is embedded on.

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.

File type filter applied

User Permissions (ACL)

The plugin adds two separate privileges:

  • momo_media_cleanup:read — access to the dashboard and the unused media list

  • momo_media_cleanup:delete — permission to delete unused media files

Staff can review the list without having delete access.

Technical Details

Property
Value

Shopware compatibility

6.6.x

PHP

8.2+

External services

None — the plugin communicates only with your own Shopware instance

Database migrations

None — the plugin does not create any custom tables

Last updated