Eli Hanna

CoffeeWP Media Cleanup helps you reclaim disk space and tidy up your WordPress media library without risking data loss. Every destructive action moves files to an internal trash so you can recover anything you did not mean to delete.
A guided three-step wizard walks you through the work:
<ol>
<li>Pre-scan settings — review detected page-builder compatibility, pick which thumbnail sizes WordPress should generate, and choose a batch size that fits your server.</li>
<li>Scan — walk your uploads tree and detect which files are unused, broken, or missing.</li>
<li>Results — see what is unused, what is broken, what is missing, which thumbnails are stale, and run targeted clean actions on selected rows or across the whole result set.</li>
</ol>
Clean actions:
<ul>
<li>Delete unused media (file moves to trash; attachment record soft-deleted).</li>
<li>Delete missing files (clears DB rows whose backing file is gone).</li>
<li>Delete broken-link records (clears attachment posts whose files never existed).</li>
<li>Delete orphan thumbnails (removes derivative files with no attachment parent).</li>
<li>Regenerate missing thumbnails (re-runs WordPress’s image-size pipeline).</li>
<li>Add orphan files to the Media Library (creates attachment records for unattached files).</li>
</ul>
Trash + restore:
A dedicated Trash view lists every file the plugin has moved out. Restore any item with one click, permanently delete individual rows, or empty the trash. Optional auto-delete after N days. Trashed files live under <code>wp-content/uploads/cwpm/trash/</code> and are protected from being overwritten by new uploads (filename collisions are detected and avoided).
Activity log:
Every clean action writes to a daily log file at <code>wp-content/uploads/cwpm/logs/</code>. The Logs view shows each file with size and download link. Optional auto-delete after 30 days.
Designed to be safe:
<ul>
<li>Soft-delete by default — no file is ever permanently removed except via the explicit “Empty trash” or “Permanent delete” controls.</li>
<li>Per-row checkboxes and a typed-confirmation disclaimer modal gate the destructive actions.</li>
</ul>
<h3>External Services</h3>
This plugin does not connect to any external services. No data leaves your WordPress install.
<h3>Third-Party Libraries</h3>
The plugin bundles these GPL-compatible libraries (LICENSE files shipped alongside each):
<ul>
<li>Color Punch (MIT) — internal CSS / JS UI framework. Shipped at <code>assets/vendor/color-punch/</code>.</li>
<li>Font Awesome Free (CC BY 4.0 icons + SIL OFL 1.1 fonts + MIT code) — icon font. Shipped at <code>assets/vendor/font-awesome/</code>. Upstream: https://fontawesome.com/</li>
<li>Rubik, Outfit, Fira Code fonts (SIL OFL 1.1) — bundled with Color Punch under <code>assets/vendor/color-punch/fonts/</code>.</li>
<li>Catppuccin color palette (MIT) — applied via Color Punch theme variants. Upstream: https://github.com/catppuccin/catppuccin</li>
</ul>
<h3>Data + Storage</h3>
Custom database tables (created on activation, dropped only on uninstall when you enable “Delete data on uninstall”):
<ul>
<li><code>{prefix}_cwpm_scan_results</code> — per-file scan output (rel_path, attachment_id, usage flags, thumbnail status).</li>
<li><code>{prefix}_cwpm_trash</code> — trashed-file ledger (rel_path, original_path, file_name, file_size, trashed_at).</li>
<li><code>{prefix}_cwpm_file_hashes</code> — md5 hashes computed during scan; reserved for future identity-matching features.</li>
</ul>
On-disk storage (under <code>wp-content/uploads/cwpm/</code>):
<ul>
<li><code>wp-content/uploads/cwpm/trash/</code> — files moved by the trash system. Recoverable until you Permanent-Delete or Empty-Trash.</li>
<li><code>wp-content/uploads/cwpm/logs/</code> — daily activity logs (one file per day, e.g. <code>cwpm-2026-05-13.log</code>).</li>
</ul>
Both folders contain <code>.htaccess</code> + <code>index.php</code> stubs to prevent direct web access.
Options + transients: all keys start with <code>cwpm_</code>. Stored in <code>wp_options</code>. Per-user preferences (theme, table density) stored in <code>wp_usermeta</code> with the same prefix.
Custom post type: <code>cwpm-trash</code> — used as a soft-delete state for attachment posts. The attachment record stays in <code>wp_posts</code> but is hidden from the Media Library until restored.

CoffeeWP Media Cleanup – Scan and Remove Unused Media and Orphan Thumbnails

Step-by-step wizard to clean unused media, orphan thumbnails, and broken attachments — safely, with one-click restore.

wowpress.host

Fix Media Library fixes inconsistency between wp-content/uploads folder and 
database. 
Fixes corrupted Media Library database records. 
Designed to run smoothly against huge Media Libraries containing hundreds of thousands of images.
Useful when:
<ul>
<li>Really old database is used and there are a lot of problems with Media Library found</li>
<li>New thumbnail sizes are registered</li>
<li>Some thumbnail sizes are not used anymore (theme change, upgrade), but image files are still exists</li>
<li>There are Media Library entries present pointing to image files that don’t exist anymore</li>
<li>Some entries in Media Library are not displayed, while image files are present (_wp_attachment_metadata meta field corrupted)</li>
<li>There are a lot of images in wp-content/uploads folder that are no longer used</li>
<li>There are duplicate attachments pointing to the same image file</li>
<li>Images are used by website, but you can’t find them in Media Library</li>
<li>You want to update attachments GUID fields containing old/staging urls</li>
<li>Detects major database corruptions affecting media library functionality</li>
</ul>
At <a href="https://wowpress.host/" rel="nofollow ugc">WowPress.host</a> company we regularly migrate very old databases and clean it up to make sure website using it is running smoothly. Those databases have all different kinds of inconsistencies collected during years or even decades of usage, and Media Library is the most common problematic piece of data here. 
That plugin helps to solve most common problems related to Media Library data.
We use a lot of open-source tools in our work, and therefore decided publish our own tools so that those can be used by the community too.
<h4>Need Help? Found A Bug? Want To Contribute Code?</h4>
Support for this plugin is provided via the <a href="https://wordpress.org/support/plugin/wow-media-library-fix" rel="ugc">WordPress.org forums</a>.
The source code for this plugin is available on <a href="https://github.com/wowpress-host/wow-media-library-fix" rel="nofollow ugc">GitHub</a>.
Paid support at <a href="https://wowpress.host/professional-services/" rel="nofollow ugc">WowPress.host</a>.

Fix Media Library

This plugin is legitimate.  Works perfectly.  Of course, with everything you do in WP related to the database and files; you should ALWAYS pull your own backups.  However, I had no need to use them.  It worked the first time and did a miracle for a client's site I was working on.

Amazing. Flawless.

Fix Media Library inconsistency between database and wp-content/uploads folder contents. Unused image files, broken media library entries, missing att …

CoffeeWP Media Cleanup – Scan and Remove Unused Media and Orphan Thumbnails vs Fix Media Library