Title: Media Reference Inspector Author: rejoyan9009 Published: අගෝස්තු 14, 2026 Last modified: අගෝස්තු 16, 2026 --- Search plugins ![](https://ps.w.org/media-reference-inspector/assets/banner-772x250.png?rev=3647213) ![](https://ps.w.org/media-reference-inspector/assets/icon.svg?rev=3647213) # Media Reference Inspector By [rejoyan9009](https://profiles.wordpress.org/rejoyan9009/) [Download](https://downloads.wordpress.org/plugin/media-reference-inspector.2.1.0.zip) * [Details](https://si.wordpress.org/plugins/media-reference-inspector/#description) * [Reviews](https://si.wordpress.org/plugins/media-reference-inspector/#reviews) * [Installation](https://si.wordpress.org/plugins/media-reference-inspector/#installation) * [Development](https://si.wordpress.org/plugins/media-reference-inspector/#developers) [Support](https://wordpress.org/support/plugin/media-reference-inspector/) ## Description Media Reference Inspector is a read-only WordPress admin tool for checking where Media Library items are referenced. The plugin does not delete files, modify content, create database tables, track users, or send analytics. Scan results are advisory: “No supported references found” does not prove that a file is unused. #### Scanner Inspect one media item at a time with a professional WordPress-native workflow. Supported checks include: * Post, page, custom post type, synced/reusable block, and other post content or excerpts containing the primary URL, generated image-size URLs, or the WordPress` wp-image-ID` class. * Core Image, Gallery, Cover, Media & Text, File, Audio, and Video blocks that store attachment IDs. * Featured images stored in `_thumbnail_id` metadata. * Navigation menu custom URLs. * WordPress Site Icon and Site Logo. * Active theme Custom Logo, Header Image, and Background Image settings. * Core media widgets and block widgets. * WooCommerce product gallery and product-category thumbnail attachment IDs. * Elementor saved media-control references when the saved JSON confirms the attachment ID. #### Bulk Scan Bulk Scan processes media items one at a time through bounded AJAX requests. It supports media type, upload-age, search, and maximum-item filters, live progress, result filtering, and CSV export. #### Diagnostics The Diagnostics tab shows the exact plugin basename and WordPress core `update_plugins` cache entry that control Dashboard update notices. Administrators can refresh WordPress plugin update metadata without changing media or content. #### Privacy Media Reference Inspector does not send media or site data to external analytics or telemetry services and stores no scan history. ## Screenshots [⌊Browse Media Library items from Media > Media References and choose an item to inspect.⌉⌊Browse Media Library items from Media > Media References and choose an item to inspect.⌉[ Browse Media Library items from Media > Media References and choose an item to inspect. [⌊Review the scan result and safety warning when no supported references are found.⌉⌊ Review the scan result and safety warning when no supported references are found .⌉[ Review the scan result and safety warning when no supported references are found. ## Installation 1. Install Media Reference Inspector from the WordPress Plugin Directory, or upload an approved test ZIP. 2. Activate the plugin. 3. Go to Media > Media References. 4. Use Scanner for one media item, Bulk Scan for an audit batch, or Diagnostics for update/status information. ## FAQ ### Does this plugin delete media files? No. It is intentionally read-only for media and content. The Diagnostics refresh action only refreshes WordPress core plugin-update cache data. ### Does “No supported references found” mean the file is safe to delete? No. Themes, builders, custom tables, external applications, caches, or custom code may store references outside the supported checks. ### Which WordPress blocks are detected by attachment ID? Image, Gallery, Cover, Media & Text, File, Audio, and Video blocks are detected when their saved attributes reference the selected attachment. ### Does the plugin detect resized image URLs? Yes. It checks generated image-size URLs recorded in WordPress attachment metadata as well as the primary attachment URL. ### What does the Diagnostics tab check? It shows the installed plugin version, actual plugin basename, WordPress/PHP versions, the version WordPress core last checked, and whether the `update_plugins` transient currently contains an update response for this exact plugin file. ### Who can use the scanner? The scanner requires the `manage_options` capability because results may reveal references to non-public content. Refreshing update metadata also requires the ` update_plugins` capability. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Media Reference Inspector” is open source software. The following people have contributed to this plugin. Contributors * [ rejoyan9009 ](https://profiles.wordpress.org/rejoyan9009/) [Translate “Media Reference Inspector” into your language.](https://translate.wordpress.org/projects/wp-plugins/media-reference-inspector) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/media-reference-inspector/), check out the [SVN repository](https://plugins.svn.wordpress.org/media-reference-inspector/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/media-reference-inspector/) by [RSS](https://plugins.trac.wordpress.org/log/media-reference-inspector/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.1.0 * Added Diagnostics with exact plugin-basename and WordPress core update-cache visibility plus a nonce-protected update-status refresh action. * Added core media widget and block-widget reference detection. * Added WooCommerce product-category thumbnail detection. * Added a scanner coverage summary for core, widgets, WooCommerce, and Elementor checks. * Added bulk upload-age filtering and increased bounded bulk batches up to 250 items. * Expanded CSV exports with media URL, file size, and upload date. * Added keyboard focus and reduced-motion accessibility polish. #### 2.0.0 * Redesigned the admin experience with a professional WordPress-native header and Scanner, Bulk Scan, and Help navigation. * Added responsive media cards, grouped scan results, clearer status states, and follow-up Edit/View actions. * Added bounded AJAX bulk scanning, live progress, result filtering, and CSV export. * Added a Media Library “Check references” row action. * Added WooCommerce product gallery detection. * Added Elementor saved media-control detection with JSON validation. * Preserved all 1.1.0 reference checks and read-only behavior. #### 1.1.0 * Added generated image-size URL detection and core media-block attachment ID detection. * Extended menu, header, and background checks to generated URL variants. * Added post IDs to content-reference labels. #### 1.0.2 * Improved prepared SQL analysis and validated read-only navigation inputs. #### 1.0.1 * Improved responsive media-list layout and mobile usability. #### 1.0.0 * Initial release with read-only reference checks for standard WordPress content and settings. ## Meta * Version **2.1.0** * Last updated **40 minutes ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **7.0.4** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/media-reference-inspector/) * Tags * [Admin Tools](https://si.wordpress.org/plugins/tags/admin-tools/)[attachments](https://si.wordpress.org/plugins/tags/attachments/) [media library](https://si.wordpress.org/plugins/tags/media-library/)[media usage](https://si.wordpress.org/plugins/tags/media-usage/) [references](https://si.wordpress.org/plugins/tags/references/) * [Advanced View](https://si.wordpress.org/plugins/media-reference-inspector/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/media-reference-inspector/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/media-reference-inspector/reviews/) ## Contributors * [ rejoyan9009 ](https://profiles.wordpress.org/rejoyan9009/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/media-reference-inspector/)