Media Dependency Mapper
"Media Depedency Mapper" is a WordPress plugin that scans your database to show where media attachments are used and warns before deletion.
by Subrata Sarkar · github.com/emfluenceindia/media-dependency-mapper · website
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/emfluenceindia/media-dependency-mapper/archive/refs/heads/master.zipReadme
Media Dependency Mapper
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.