Media Reference Inspector
Media Reference Inspector is a small, read-only admin tool for checking where an individual Media Library item is referenced.
The plugin focuses on standard WordPress locations and intentionally does not delete files, change content, create database tables, track users, or call external services.
Supported reference checks in version 1.1.0:
- Post, page, and custom post type content or excerpts that contain the original media URL, a generated image-size URL, or the WordPress
wp-image-IDclass. - Core WordPress media blocks that store attachment IDs: Image, Gallery, Cover, Media & Text, File, Audio, and Video.
- Featured images stored with WordPress core
_thumbnail_idmetadata. - Navigation menu custom URLs that exactly match the original media URL or a generated image-size URL.
- WordPress Site Icon and Site Logo settings.
- Active theme Custom Logo, Header Image, and Background Image settings, including generated image-size URL variants where applicable.
Scan results include the post ID for content references to make follow-up checks easier.
The results are advisory. A result of « no references found » does not prove that a file is unused. Themes, page builders, custom database tables, external systems, custom code, or plugin-specific storage can reference media in other ways.
Privacy
Media Reference Inspector does not send data to external services and does not add tracking or analytics. It stores no plugin settings or scan history.
