Eli Hanna

<p>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.</p>
<p>A guided three-step wizard walks you through the work:</p>
<ol>
<li><strong>Pre-scan settings</strong> — review detected page-builder compatibility, pick which thumbnail sizes WordPress should generate, and choose a batch size that fits your server.</li>
<li><strong>Scan</strong> — walk your uploads tree and detect which files are unused, broken, or missing.</li>
<li><strong>Results</strong> — 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>
<p><strong>Clean actions:</strong></p>
<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>
<p><strong>Trash + restore:</strong></p>
<p>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).</p>
<p><strong>Activity log:</strong></p>
<p>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.</p>
<p><strong>Designed to be safe:</strong></p>
<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>
<p>This plugin does not connect to any external services. No data leaves your WordPress install.</p>
<h3>Third-Party Libraries</h3>
<p>The plugin bundles these GPL-compatible libraries (LICENSE files shipped alongside each):</p>
<ul>
<li><strong>Color Punch</strong> (MIT) — internal CSS / JS UI framework. Shipped at <code>assets/vendor/color-punch/</code>.</li>
<li><strong>Font Awesome Free</strong> (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><strong>Rubik</strong>, <strong>Outfit</strong>, <strong>Fira Code</strong> fonts (SIL OFL 1.1) — bundled with Color Punch under <code>assets/vendor/color-punch/fonts/</code>.</li>
<li><strong>Catppuccin</strong> color palette (MIT) — applied via Color Punch theme variants. Upstream: https://github.com/catppuccin/catppuccin</li>
</ul>
<h3>Data + Storage</h3>
<p><strong>Custom database tables</strong> (created on activation, dropped only on uninstall when you enable “Delete data on uninstall”):</p>
<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>
<p><strong>On-disk storage</strong> (under <code>wp-content/uploads/cwpm/</code>):</p>
<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>
<p>Both folders contain <code>.htaccess</code> + <code>index.php</code> stubs to prevent direct web access.</p>
<p><strong>Options + transients:</strong> 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.</p>
<p><strong>Custom post type:</strong> <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.</p>


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.

Spencer Piontkowski

<h4>What is this?</h4>
<p>I found the WordPress Importer plugin is good for importing posts and comments, but is lacking when it comes to importing large attachments (like images) from large sites. My import would often time out and crash. I wrote this plugin to help with my own blog migrations, but I hope you find it useful too.</p>
<h4>Usage</h4>
<ol>
<li>As a prerequisite, import your WXR file using the WordPress importer, but do not select the option to Download and Import Attachments. I have found that an import file up to 15MB big will work as long as you don’t import attachments.</li>
<li>Navigate to the Attachment Importer screen.</li>
<li>Select your WXR export file.</li>
<li>Select the user you would like to be the owner of the downloaded images. Default: current user.</li>
<li>Sit back and let the importer run. The process can take as little as 10 seconds for 10 images, or about two hours for 2000 images. These times depend on the server that hosts your WordPress site.</li>
<li>If you receive any errors during the process, try running the file again after it finishes.  The plugin is programmed to ignore files that match the following criteria:
<ul>
<li>Same name</li>
<li>Same file name</li>
<li>Same upload date</li>
<li>Same file size</li>
</ul>
</li>
</ol>
<h4>How it works.</h4>
<p>This plugin uses <a href="https://developer.mozilla.org/en-US/docs/Web/API/FileReader" rel="nofollow ugc">FileReader</a> and to parse the XML file in the browser, then uses ajax to request WordPress perform individual uploads.</p>
<h4>License</h4>
<p>Attachment Importer – A plugin for WordPress to import attachments from another blog using a WXR file.<br />
Copyright (C) 2014 Toasted Lime</p>
<p>This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.</p>
<p>The license and copyright applies to all resources bundled with this plugin, except as noted below:</p>
<p>Portions of this plugin use code from:</p>
<ul>
<li><a href="https://wordpress.org/extend/plugins/wordpress-importer/" rel="ugc">WordPress Importer</a> which is distributed under the terms of the GNU GPL v2, Copyright (C) 2013 wordpressdotorg.</li>
<li><a href="http://jqueryui.com/themeroller/" rel="nofollow ugc">jQuery UI Smoothness Theme</a> which is distributed under the terms of MIT License, Copyright (C) 2014 jQuery Foundation and other contributors.</li>
</ul>
<h3>Changeset</h3>
<h4>0.6.0</h4>
<p>Should not get “Remote server did not respond” as often.</p>
<h4>0.5.6</h4>
<ul>
<li>Invalid file type produces non-fatal error.</li>
</ul>
<h4>0.5.5</h4>
<ul>
<li>Added an overall progress bar.</li>
<li>Improve how the program responds to events like fatal errors, AJAX failure, or if there are no attachments in the import file.</li>
</ul>
<h4>0.5.4</h4>
<ul>
<li>Fixed issue reading namespaces in import file that caused the program not to work in FireFox and Internet Explorer.</li>
<li>Moved plugin to Import menu from the Media menu.</li>
</ul>
<h4>0.5.3</h4>
<ul>
<li>Added option to add five second delay between image ajax requests</li>
<li>Reformat Readme</li>
<li>Added jQuery tooltip</li>
</ul>


Attachment Importer

Thank you so much for sharing this with the WP community. It helped me get around timeouts and so much frustration. I didn't find any problems with the plugin.

Very helpful plugin that works

I found this plug-in as I was having trouble moving data on a shared server that can not be migrated.
Importing of media that has failed many times is proceeding smoothly.
Thank you for a wonderful plugin !!

Thank you so much!!!!

Even though the plugin hasn't been updated for quite a while, it still works great even with the latest WordPress (5.3). Thanks for the development!

Still great!

Import attachments from another WordPress blog using a WXR file.

CoffeeWP Media Cleanup – Scan and Remove Unused Media and Orphan Thumbnails vs Attachment Importer