Unused Image Cleaner
Unused Image Cleaner is a smart, lightweight plugin that helps you identify and safely clean unused images from your WordPress uploads folder.
by Ashokkumar Dubariya · github.com/ashokdubariya/wordpress-unused-image-cleaner
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/ashokdubariya/wordpress-unused-image-cleaner/archive/refs/heads/main.zipUnused Image Cleaner - Smart WordPress Media Cleaner
Unused Image Cleaner is a smart, lightweight plugin that helps you identify and safely clean unused images from your WordPress uploads folder.
Identify and safely clean unused images from your WordPress uploads folder with scoring, backup & restore, and automated scans.
Features
- Scoring system with 8-factor heuristic analysis
- Safe backup and restore functionality
- Visual dashboard with thumbnail previews
- Automatic weekly scanning with email notifications
- Activity logging with complete audit trail
- Bulk operations for deleting multiple images
- Permanent delete option with double confirmation
- Configurable settings for score threshold, automatic scanning, image types
- Metadata recovery system for backed-up files
- Manual scan tracking in activity logs
- Professional admin UI with responsive design
- Support for multiple image formats (JPG, PNG, GIF, WebP, SVG, ICO)
Requirements
- PHP 7.4 or higher
- WordPress 5.0 or higher
How it works?
- The plugin scans your uploads folder and scores each image by score threshold (0-100)
- Higher scores indicate likely unused images (thumbnails, old files, etc.)
- Review results with powerful filters and search
- Move unused images to backup (safe, reversible)
- Permanently delete only when you're sure
Perfect For
- E-commerce sites with many product images
- Photography websites
- Long-running blogs with accumulated media
- Sites after theme/plugin changes
- After imports or migrations
Installation
- Upload the plugin files to
/wp-content/plugins/unused-image-cleaner/ - Activate the plugin through the 'Plugins' menu in WordPress
- Navigate to 'Unused Images' in your admin menu
- Review results and move unwanted images to backup
Frequently Asked Questions
Is it safe to use?
Yes! All deleted images are moved to a backup folder, not permanently deleted. You can restore them at any time.
Will it delete images I'm using?
The plugin checks your database and content for image usage. Start with a high threshold (70+) to only find obvious unused files like auto-generated thumbnails.
What happens if I delete an image by mistake?
Simply go to the Backup & Restore section and restore it. All backed-up images retain their original filenames and locations.
How do I permanently delete backed-up images?
In the Backup & Restore section, select files and click "Delete Permanently". This action cannot be undone.
Can I schedule automatic scans?
Yes! Go to Settings and Enable weekly automatic scanning.
What is the Score Threshold?
It's a minimum score filter (0-100). Higher scores indicate higher confidence that an image is unused:
- 0-39: Low confidence (may be in use)
- 40-69: Medium confidence (review carefully)
- 70-100: High confidence (likely unused thumbnails/old files)
Can I filter results?
Yes! Filter by score, file type (JPG, PNG, GIF, etc.), file age, and search by filename.
Privacy Policy
This plugin does not collect or transmit any user data. All operations are performed locally on your WordPress installation.