How to Find and Remove Unused WordPress Media Safely

An attachment with no parent is not necessarily unused. It may be a featured image, a WooCommerce gallery item, a Gutenberg block asset, a widget image, an ACF value, or a file referenced directly by URL. Deleting media based on one database column is how production sites lose images.

Mediachecker approaches cleanup as an evidence problem. It checks several independent reference signals, protects recent uploads, and verifies an attachment again immediately before deletion.

Why WordPress media ownership is difficult

WordPress stores media as attachment posts, but themes and plugins are free to reference those IDs or URLs almost anywhere. Some relationships are structured; others are serialized inside options or embedded in block markup. A reliable audit therefore needs to search relationships, content, metadata, widgets, and files rather than trusting one field.

The seven reference signals worth checking

• Attachment parents and featured-image relationships.
• Post meta, including WooCommerce galleries and custom-field values.
• Gallery shortcodes and Gutenberg block JSON.
• Full URLs, filenames, and generated image-size variants in content.
• Widget and sidebar configuration stored in options.
• Theme templates, template parts, PHP includes, and stylesheets.
• Recent-upload age, which protects assets that may belong to unfinished content.

Use classification before deletion

A scan result should be treated as a review queue, not a deletion order. Filter by type and size, inspect the attachment, and confirm whether the site uses a custom storage pattern. On unfamiliar builds, export the results and ask the developer how the theme stores media before making changes.

A production-safe cleanup sequence

• Run the first scan without changing anything.
• Keep the recent-upload protection enabled.
• Export the audit results as CSV for review.
• Run a dry deletion pass and examine the proposed set.
• Create a metadata or ZIP backup of the selected files.
• Delete in small batches and re-check important templates after each batch.
• Keep the activity log until the cleanup has been accepted.

Duplicates are a separate decision

Two files with the same name are not proof of duplication, and two visually similar images may serve different crops or contexts. Exact hashing can identify byte-identical files. Perceptual hashing can surface visually similar candidates. Neither should automatically decide which attachment record, metadata, or URL is safe to remove.

Where AI helps and where it does not

AI can draft alt text, categorize media, and explain why an asset appears safe or risky. It should not bypass reference checks or backups. Mediachecker keeps visual duplicate detection local and makes AI media tools optional, so administrators can use the core audit without sending images to a provider.

Install Mediachecker

• Download the current ZIP from the Mediachecker page.
• Install and activate it from Plugins > Add New Plugin.
• Open Media > Mediachecker and let the initial scan finish.
• Review Unused Media and Duplicate candidates before enabling any cleanup action.
• Configure scheduled scans only after the first manual audit is understood.

A better cleanup target

The objective is not the smallest possible uploads directory. It is a media library whose ownership is understood and whose unnecessary files can be removed reversibly. If your theme or page builder stores references in a custom format, ask WPStack to review the integration before running a large cleanup.

Frequently asked questions

Related reading

See the complete Mediachecker plugin details, then connect media cleanup with better image alt-text workflows and the post-release maintenance checklist.

Create a deletion manifest, not a visual guess

A media item can be absent from post content and still be used by a theme option, Elementor template, custom field, WooCommerce variation, email template, CSS file, or external integration. Before deletion, export candidate attachment IDs with filenames, URLs, upload dates, sizes, and detected references. Treat that manifest as the review queue and the rollback record.

Check the places ordinary scans miss

• Featured images, galleries, reusable blocks, and navigation items
• Elementor templates, global widgets, background images, and generated CSS
• Pods or other custom-field values that store attachment IDs or URLs
• WooCommerce product galleries and variation images
• Theme options, widgets, email templates, and hard-coded CSS references

Use quarantine before permanent removal

Move confirmed candidates to a reversible quarantine or retain a complete backup for at least one normal publishing and sales cycle. Clear caches, regenerate builder CSS where appropriate, and crawl representative pages for broken images. Test transactional email, checkout, account screens, search results, social previews, and structured data rather than checking only the homepage.

Measure reclaimed disk space separately from performance. Removing unused files primarily improves storage hygiene and backup size; it does not automatically make front-end pages faster unless those files were being requested.

Aditya Bhimrajka

Aditya Bhimrajka is a technology entrepreneur, product strategist, and software solutions expert with over a decade of experience building scalable web and mobile applications. His expertise spans SaaS, AI, cloud technologies, custom software development, and digital transformation. Passionate about solving real-world business challenges through technology, Aditya shares practical insights on WordPress, plugins, software development, startup growth, product strategy, and emerging technologies. At WPStack, he writes actionable, experience-driven content that helps developers, businesses, and website owners build secure, high-performing, and future-ready WordPress solutions.