Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/code-caste/codecaste-unused-media-usage-audit/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Find potentially unused images in your WordPress Media Library and clean them up safely.
This WordPress plugin scans posts, pages, ACF fields, WooCommerce products, Elementor data, widgets, and settings to build a reference index, then flags media with no detectable references. Review everything before delete. No auto-deletion.
Who it's for
- Site owners cleaning Media Library bloat
- Agencies maintaining WordPress and WooCommerce sites
- Teams that want safer unused-image detection across Elementor and ACF
Features
- Builds a reference index of images in use across content and meta
- Flags media with no detectable references as Potentially Unused
- No auto-deletion — admins review and delete manually
- Batch scanning designed for large media libraries
- Automatic rescans when content changes
- Coverage for posts, ACF, WooCommerce, Elementor, widgets, and settings
Requirements
- WordPress 5.6+
- PHP 7.4+
Installation
- Download or clone this repository into
wp-content/plugins/codecaste-unused-media-usage-audit - Activate Unused Media Usage Audit by CodeCaste in WordPress
- Open Tools → Unused Images to scan and review results
Repository
- GitHub: https://github.com/code-caste/codecaste-unused-media-usage-audit
- Organization: code-caste
- Maintainer: Bhushan-Gohel
- Website: CodeCaste
Changelog
1.3.0
- Public rebrand to Unused Media Usage Audit by CodeCaste
- Text domain / slug:
codecaste-unused-media-usage-audit - Internal option prefix moved to
codecaste_mcs_*
See readme.txt for the full changelog.
License
GPLv2 or later — see LICENSE.