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-ID class.
• Core WordPress media blocks that store attachment IDs: Image, Gallery, Cover, Media & Text, File, Audio, and Video.
• Featured images stored with WordPress core _thumbnail_id metadata.
• 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.