About this plugin
Media Sweep: The Ultimate WordPress Media Library Cleaner
Media Sweep is a powerful WordPress plugin designed to help you reclaim valuable server space by identifying and safely removing unused media files from your WordPress site. Whether you’re dealing with orphaned attachments, forgotten uploads, or files left behind by themes and plugins, Media Sweep provides a comprehensive solution to keep your media library clean and organized.
Perfect for bloggers, agencies, e-commerce sites, and any WordPress website looking to optimize storage space and improve site performance.
🚀 Key Benefits:
✅ Reclaim Server Space – Remove unused files and free up valuable storage
✅ Improve Site Performance – Faster backups and reduced server load
✅ Safe & Reversible – Files moved to trash folder, not permanently deleted
✅ Smart Detection – Advanced algorithms identify truly unused files
✅ Batch Operations – Process multiple files efficiently
✅ Detailed Analytics – Comprehensive scan reports and file insights
✅ AI Assistant Ready – Audit scans and preview cleanups from Claude or Cursor over MCP; deleting stays off by default
🎯 Core Features
🔍 Dual Scan Modes
Media Library Scan
* Scans all media attachments in your WordPress library
* Checks for usage in posts, pages, and custom fields
* Detects thumbnail and size variations
* Identifies gallery shortcodes and blocks
* Fast and efficient for large media libraries
* Recommended for most WordPress sites
File System Scan
* Deep scan of your uploads directory
* Finds orphaned files not in the media library
* Detects cache and temporary files
* Identifies theme and plugin generated files
* Comprehensive but may take longer to complete
* Best for sites with file management plugins
📊 Smart File Detection
- Usage Analysis – Checks posts, pages, custom fields, and widgets
- Database Scanning – Searches content for file references
- Shortcode Detection – Identifies gallery and media shortcodes
- Block Analysis – Scans Gutenberg blocks for media usage
- Plugin Integration – Detects files used by popular plugins
- Theme Assets – Identifies theme-related media files
🗂️ Advanced File Management
- Status Classification – Files categorized as In Use, Unused, or Orphaned
- Bulk Actions – Select and process multiple files at once
- Smart Filtering – Filter by file type, status, date, and directory
- Search Functionality – Quickly find specific files
- Preview Mode – View files before taking action
- Detailed File Info – Size, type, usage locations, and more
🛡️ Safety Features
- Trash System – Files moved to secure trash folder, not deleted
- Restore Capability – Easily restore accidentally removed files
- Backup Integration – Works with popular backup plugins
- Progress Monitoring – Real-time scan progress with pause/resume
- System Resources – Intelligent resource management prevents timeouts
- Rollback Protection – Safe operations with detailed logging
📈 Comprehensive Analytics
- Scan History – Track all previous scans and results
- Storage Statistics – See exactly how much space you’ve reclaimed
- File Breakdown – Detailed analysis by file type and status
- Usage Patterns – Understand your media library usage
- Performance Metrics – Scan duration and processing statistics
🚀 Easy 3-Step Process
Step 1: Choose Scan Type
* Select Media Library or File System scan based on your needs
* Configure advanced options for thorough analysis
Step 2: Run the Scan
* Watch real-time progress as Media Sweep analyzes your files
* Pause and resume scans as needed without losing progress
Step 3: Review & Clean
* Browse detected files with detailed information
* Use bulk actions to efficiently process multiple files
* Restore files from trash if needed
🔧 Advanced Configuration
- Scan Options – Deep scan, thumbnail inclusion, custom field checking
- File Type Filters – Focus on specific file types (images, documents, etc.)
- Directory Exclusions – Skip specific folders during scans
- Performance Settings – Adjust batch sizes and resource limits
- Automation Rules – Set up automatic cleanup schedules (planned for future versions)
🤖 Works with AI Assistants (Claude and Cursor via MCP)
9. Install the free MCP Adapter plugin from the WordPress project and MCP clients that sign in with a WordPress Application Password (Claude Desktop, Claude Code, Cursor) can audit your Media Library in plain English. Verified with Claude Code.
What an AI assistant can do:
- Start a Media Library scan, run it to the end and read the counts: in use, unused, orphaned
- List past scans and check the progress of a running one
- List the files a scan found, with path, size, type and verdict
- Explain why a file counts as in use, naming the post, custom field or option that references it
- Preview a cleanup before anything moves: how many files, how much space, how many attachments and thumbnails it would touch
- See what is in the trash and how much space it holds
- Check your server’s headroom and get a recommended batch size
- Read the two settings that arm automatic deletion, so it can warn you they are on
- Put files found on disk but missing from the library back into the Media Library
”
”
”
What it deliberately cannot do:
- Delete files over MCP. Deletion is off by default; you can opt in with your own code. Even then, a delete needs a confirmation token minted by a preview of the exact file list, in-use files are always skipped, and the originals go to the Media Sweep trash like any other sweep.
- Empty the trash, delete a single trash file, purge old trash, delete scan records, change a file’s verdict or change settings. None of these are exposed to agents at all, so the site always keeps an undo.
- Run a File System scan. That one stays in wp-admin.
- Act as anyone but an administrator. Every operation checks the administrator capability, and a filter can require more than that, never less.
9 or newer, the free MCP Adapter plugin (not bundled with Media Sweep and not required), and a WordPress Application Password for a dedicated admin user (Users > Profile > Application Passwords). WP-CLI works on the same machine. Nothing changes for sites that skip this: on older WordPress, or without the adapter, Media Sweep runs exactly as before, and nothing leaves your server.
💡 Perfect For
- Content Creators – Bloggers and publishers with large media libraries
- Web Agencies – Managing multiple client sites efficiently
- E-commerce Sites – Cleaning up product images and assets
- Membership Sites – Optimizing user-generated content
- Portfolio Sites – Managing large image collections
- News Sites – Handling high-volume media uploads
Support
Need help with Media Sweep? We’re here to assist!
- Support Forum: WordPress.org support forum
- Feature Requests: Submit ideas and suggestions
- Bug Reports: Report issues for quick resolution
External services
com (usage data and newsletter, both opt-in).
Nothing is sent unless you click one of these buttons. Skip sends nothing.
- Allow (usage data): your site address, your WordPress, PHP and plugin versions, the plugins and themes you use, and rounded usage counts. Sent once a week and when a WPCreatix plugin is activated, updated or removed. Never your content, customers, orders or passwords.
- Subscribe (newsletter): the email you enter, with proof of the signup. Every email has an unsubscribe link.
- Submit and deactivate (feedback): the reason you pick, your note, and your email only if you tick the box.
On Media Sweep’s settings page you can see what is sent, turn sharing off, or delete your site’s data at any time.
com/terms-and-conditions/
com/privacy-policy/
Privacy
Scans, cleanups and the trash all run locally on your server, and your files and media never leave it. Media Sweep contacts an outside service only in the cases listed under External services.
Credits
Media Sweep is crafted with ❤️ by the WPCreatix team. We’re passionate about creating tools that help WordPress users optimize and maintain their websites efficiently.
Special thanks to the WordPress community for their continuous feedback and support in making this plugin better.