Opens in a new tab
WP PowerSuite home
Turquoise abstract wavy W logo on a black background
Black
Friday
SALE
UP TO70%OFF

Summarize with AI:

On This Page
Last updated: 04/09/2026

Unused Media Finder

Find media files not used anywhere on your site and delete them to reclaim storage space. Clean up orphaned images from deleted posts, old test uploads, and imported content.

Overview

Unused Media Finder scans the WordPress Media Library for attachments that do not appear to be referenced by supported content signals, helping administrators identify files that may no longer be needed.

The scanner checks featured-image relationships and common media references in public post content, including classic galleries, Gutenberg image-related blocks, wp-image classes, and uploads URLs. Potentially unused attachments are shown with preview, size, MIME type, and deletion controls so you can review them before making a decision.

Because WordPress media can be referenced from many places outside normal post content, results are intentionally presented as candidates rather than guaranteed-unused files. Unused Media Finder is a Pro module in WP PowerSuite.

Solid black square
Solid black square
Who is this for?
  • Sites with years of accumulated Media Library attachments
  • Agencies cleaning up client websites before migration or handover
  • Administrators investigating large uploads directories
  • Content teams removing media left behind by deleted or rewritten posts
  • Developers who want a reviewable unused-media scan rather than blind filesystem deletion

Features

Batched Media Library Scan
Analyze attachments and content in incremental AJAX steps rather than one long request.
Featured Image Detection
Treat every attachment referenced by _thumbnail_id as used.
Post Content Analysis
Detect common image references in published and other eligible public post content.
Gutenberg & Gallery Signals
Recognize image, gallery, cover, media-text block IDs and classic gallery shortcodes.
Uploads URL Matching
Resolve media references found as uploads URLs back to attachment records.
Potentially Unused Results
Show title, preview, URL, size, and MIME information for attachments not found by the supported checks.
Selected & Bulk Deletion
Permanently delete reviewed unused attachments with confirmations and per-item permission checks.
Short-Lived Scan State
Keep the active scan in a temporary session rather than creating a permanent unused-media database table.
Honest Coverage Warning
Clearly warn that widgets, custom fields, builder data, WooCommerce galleries, serialized metadata, and other unsupported stores may still reference an attachment.

Find Media That May No Longer Be Used

Check Common WordPress Media References

Treat Results as Candidates, Not Absolute Truth

Review File Size Before Deleting

If the reason for running the scan is storage pressure, Storage Monitor can provide the broader WordPress storage breakdown first, helping confirm whether uploads are actually the area consuming most tracked space.
This makes cleanup more intentional: understand the scale of the storage issue, scan for possible unused media, then manually review the candidates with the largest potential impact.

Permanent Deletion Requires Extra Care

Before deleting a large group of media, maintaining a current Backup & Restore snapshot is the safer workflow. A media scan can reduce risk, but it cannot make a destructive delete reversible on its own.

Know the Current Bulk Deletion Limit

Use Cases

  • Pre-Migration Cleanup
    Identify obvious unused attachments before moving a mature WordPress site to a new server.
  • Reduce Media Storage
    Review large unused-media candidates when uploads have become a major part of site storage.
  • Clean Up Removed Content
    Find attachments left behind after posts, campaigns, or landing pages were deleted.
  • Agency Site Audits
    Provide clients with a reviewable list of potentially unused media rather than deleting files automatically.
  • Legacy Media Libraries
    Investigate years of accumulated images and documents before deciding what can be safely removed.

Frequently Asked Questions

Related Modules

Add custom image sizes beyond WordPress defaults. Create exact dimensions for hero banners, product thumbnails, or any layout requirement — no code...
Disabled
Adds smaller AVIF copies for JPEG and PNG uploads so pages can load faster. Optional setting to show those images to modern...
Disabled
Package your media library into downloadable ZIP files—the entire library, specific months, or folders (when Media Categories is enabled). ZIPs auto-expire after...
Disabled
Disk usage at a glance on the dashboard home.
Disabled
Allow SVG and SVGZ uploads in the Media Library. Restricted to administrators only.
Disabled
Allow AVIF image uploads in the Media Library. Requires GD or Imagick with AVIF support on the server.
Disabled
Replace any media file while keeping the same URL and attachment ID. Update product photos used across multiple pages without touching any...
Disabled
Generate accessible, SEO-friendly alt text with AI. Includes a dashboard, review queue, background processing, multi-provider support, REST/WP-CLI automation, and Pro extras like...
Disabled
Automatically convert uploaded JPEG and PNG images to WebP format for significantly smaller file sizes and faster page loads. Cannot be enabled...
Disabled
Automatically clean uploaded image filenames by converting to lowercase, removing special characters, and adding a unique identifier. No configuration needed.
Disabled