Dustorage – Media Library Cleanup

Description

Dustorage scans your entire WordPress site to find media files that are no longer used anywhere — not attached to any post, page, featured image, custom field, or site setting. Instead of deleting files immediately, Dustorage places them in a quarantine period, giving you time to review and restore anything deleted by mistake before it’s permanently removed.

Key Features

  • Scans the full media library and detects unused files
  • Checks featured images, post content, post meta, custom fields, and site options (logo, site icon)
  • Quarantine system: files are held for a configurable number of days before permanent deletion
  • Scheduled automatic scans (daily or weekly)
  • Activity log to track what was quarantined or deleted
  • Excluded folders setting to protect specific directories from being scanned

How It Works

  1. Dustorage scans your media library and checks each file against multiple usage rules.
  2. Files found unused are placed in quarantine (not deleted immediately).
  3. After the quarantine period ends (default: 7 days), files are permanently deleted.
  4. You can review and restore quarantined files at any time before that.

Installation

  1. Upload the dustorage-media-library-cleanup folder to the /wp-content/plugins/ directory, or install the plugin directly through the WordPress plugins screen.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Go to Dustorage Cleaner in your admin menu to run your first scan and configure settings.

FAQ

Will this delete my files immediately?

No. Files are first placed in a quarantine period (configurable, default 7 days) before permanent deletion, so you have time to review and restore anything if needed.

What counts as “used”?

Dustorage checks featured images, content inside posts and pages, post meta (including custom fields), attachment relationships, and site options such as the custom logo and site icon.

Can I exclude certain folders from scanning?

Yes, under Settings you can list folder paths that should never be scanned or touched by the plugin.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Dustorage – Media Library Cleanup” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.