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.

Ryan Hellyer

This plugin has been actively maintained since 2012 and is used on over 20,000 websites worldwide.
<h4>Features</h4>
The <a href="https://geek.hellyer.kiwi/products/unique-headers/" rel="nofollow ugc">Unique Headers Plugin</a> adds a custom header image box to the post/page edit screen. You can use this to upload a unique header image for that post, or use another image from your WordPress media library. When you view that page on the front-end of your site, the default header image for your site will be replaced by the unique header you selected.
This functionality also works with categories and tags.
<h4>Requirements</h4>
You must use a theme which utilizes the built-in custom header functionality of WordPress. If your theme implement it’s own header functionality, then this plugin will not work with it.
<h4>Paid WordPress development</h4>
If you would like to pay for assistance, additional features to be added to the plugin or are just looking for general WordPress development services, please contact me via <a href="https://ryan.hellyer.kiwi/contact/" rel="nofollow ugc">my contact form</a>.
<h3>Development</h3>
This section is only relevant for developers building the plugin from source (e.g. cloning from GitHub). If you installed via WordPress.org, the plugin is ready to use — no build steps required.
The plugin uses Composer for PHP autoloading and dependencies, npm for JavaScript tooling, and TypeScript for admin JavaScript.
To set up a development environment:
<ol>
<li>Install PHP dependencies: <code>composer install</code></li>
<li>Install JavaScript dependencies: <code>npm install</code></li>
<li>Compile TypeScript to JavaScript: <code>npm run build</code></li>
</ol>
To run tests and analysis:
<ul>
<li>PHPCS (PSR-12 coding standards): <code>composer phpcs</code></li>
<li>Auto-fix PHPCS violations: <code>composer phpcbf</code></li>
<li>PHP-CS-Fixer (dry-run): <code>composer cs</code></li>
<li>PHP-CS-Fixer (auto-fix): <code>composer cs:fix</code></li>
<li>PHPStan static analysis: <code>composer phpstan</code></li>
<li>PHPUnit unit tests: <code>composer test</code></li>
<li>TypeScript type checking: <code>npm run typecheck</code></li>
</ul>
TypeScript source files are in <code>src/ts/</code>. The compiled output is written to <code>assets/admin.js</code> and is what WordPress loads on the admin side.
<h4>Credits</h4>
Thanks to the following for help with the development of this plugin: 
* <a href="http://www.redactsolutions.co.uk" rel="nofollow ugc">redactuk – Assistance with debugging. 
* </a><a href="http://www.datamind.co.uk/" rel="nofollow ugc">crabsallover – Assitance with debugging. 
* </a><a href="http://onmytodd.org" rel="nofollow ugc">Todd</a> – Assistance with implementing support for tags. 
* <a href="http://westoresolutions.com/" rel="nofollow ugc">Mariano J. Ponce</a> – Spanish translation. 
* <a href="http://www.graphicana.de/" rel="nofollow ugc">Tobias Klotz</a> – Deutsch (German) language translation. 
* <a href="http://nakri.co.uk/" rel="nofollow ugc">Nadia Tokerud</a> – Proof-reading of Norsk Bokmål (Norwegian) translation. 
* <a href="http://bjornjohansen.no/" rel="nofollow ugc">Bjørn Johansen</a> – Proof-reading of Norwegian Bokmål translation. 
* <a href="https://www.facebook.com/kaljam/" rel="nofollow ugc">Karl Olofsson</a> – Proof-reading of Swedish translation. 
* <a href="http://www.jennybeaumont.com/" rel="nofollow ugc">Jenny Beaumont</a> – French translation.

Unique Headers

Great plugin!

Use it on every site. Why would soneone like to have the same header on every page? Should be in core. =)

Should have been core since .. ever?

Add unique custom header images to individual pages, posts, categories, or tags.

CoffeeWP Media Cleanup – Scan and Remove Unused Media and Orphan Thumbnails vs Unique Headers