find duplicate and broken images in WordPress

WordPress Media Library Cleanup

Find evidence of media problems and unused duplicate attachments without unsafe automatic deletion.

Target Audience

Agency developers and administrators cleaning up bloated WordPress uploads folders.

Expected Outcomes

Measure the impact of this workflow.

Outcome 01

Identify orphaned files, duplicate uploads, and broken local content links.

Outcome 02

Run safe dry runs to preview potential disk savings without risk of data loss.

Outcome 03

Safely rename attachments and automatically update database content links.

Common problems

What this workflow helps you fix.

Problem 01

Attachment records point to missing files, causing broken links and database bloat

Problem 02

Published content contains broken local URLs from migrated or deleted media files

Problem 03

Identical duplicate files are uploaded multiple times, wasting server disk space

Problem 04

Blanket automated cleanup scripts delete active layout assets, causing layout shift

Step by step

A practical Cyphex workflow

  1. Run the resumable Media Intelligence scan to build a local map of all attachments.
  2. Identify exact duplicates based on content hashes and list their usage pages.
  3. Perform a dry run to inspect missing attachments and broken links without deleting files.
  4. Perform safe file renames and allow Cyphex to update database text links dynamically.
Eligibility matters: local features use WordPress server capabilities. External AI remains optional and follows the provider account you configure.

Frequently asked questions

Will Cyphex delete duplicate images automatically?

No. Cyphex lists duplicates for manual review. We believe automated deletion is unsafe because page builders hide assets.

What is a dry run?

A dry run scans the library and simulates disk cleanup or database renaming, reporting potential findings before applying any changes.

How does it handle multisite networks?

It runs on an individual site basis, targeting local attachments and uploads paths to keep multisite structures fully isolated and safe.

Free and open source

Start your wordpress media library cleanup workflow.

Install the free plugin, scan your library, and use only the tools your site supports.