WP Manifestindependent plugin directory
manifest / media / media-dependency-mapper

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.

★ 0stars

Install

Download source zip No release zip yet

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.zip
No 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, and wp_options.
  • Fully supports native WordPress elements like Gutenberg Image Gallery blocks.

Installation

  1. Clone or download this repository.
  2. Upload the media-dependency-mapper folder to your /wp-content/plugins/ directory.
  3. Activate the plugin through the 'Plugins' menu in WordPress.
  4. 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.