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/emfluenceindia/media-dependency-mapper/archive/refs/heads/master.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Media Dependency Mapper is a powerful utility for WordPress that helps you safely manage your Media Library. It scans your database—including posts, pages, custom post types, Gutenberg blocks, Elementor, ACF, and theme options—to find exactly where each media attachment is being used.
It adds a "Deletion-Safety" score and usage count directly into your Media Library (in both Grid and List views), preventing you from accidentally deleting an image that is actively being used on your site.
Features
- Displays a Deletion-Safety Score (%) for every image with an intuitive color-coded progress bar.
- Shows the exact number of times an image is used.
- Warns you with a confirmation dialog before permanently deleting active media.
- Deeply scans
wp_posts,wp_postmeta, andwp_options. - Fully supports native WordPress elements like Gutenberg Image Gallery blocks.
Installation
- Clone or download this repository.
- Upload the
media-dependency-mapperfolder to your/wp-content/plugins/directory. - Activate the plugin through the 'Plugins' menu in WordPress.
- Visit the Media Library to see it in action.
Usage
Simply navigate to your WordPress Media Library.
- Grid View: A stats panel will appear automatically beneath each thumbnail.
- List View: A new "Dependencies" column will show the usage and safety score.
- Attachment Details: Clicking on an image will open the details modal, where a sidebar panel will list the exact posts or options where the image is currently being used.