Media Reference Inspector

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.
• Advanced Custom Fields (ACF) Image, File, and Gallery fields when ACF confirms the field type and saved attachment ID.
• Reference evidence details including confidence, source category, and context for supported results.

Bulk Scan Bulk Scan processes media items one at a time through bounded AJAX requests. It supports media type, upload-age, search, maximum-item filters, selected attachment IDs, live progress, potential-unused review filtering, reference evidence and file-health filtering, result sorting, CSV export, and a printable HTML audit report. Broken URLs Run a bounded, read-only scan for local WordPress uploads URLs saved in post content or excerpts where the corresponding local file no longer exists. The scanner checks local uploads paths only and does not make external network requests. Page & Post Audit Audit a post or page to list supported media attachment IDs, flag broken attachment IDs, and review local file health without modifying content. Duplicate Finder Run an on-demand, bounded exact-file hash scan of recent local Media Library files. The tool reports exact matches only and never deletes files. Integration Coverage The admin interface reports supported coverage for WordPress Core, WooCommerce, Elementor, and ACF so administrators can see which integration-aware checks are active on the site. Media Library Status Reference checks store a short-lived local scan-status cache for inspected attachments. Media Library workflows can show a recent reference count/status and offer an explicit re-scan without running a heavy scan on every page load. Media Impact Preview Single-item scans summarize supported reference categories that could be affected before a media item is replaced or removed. The preview is advisory and read-only. Extended Metadata and Builder Coverage 2.4 adds bounded validation for media-like post meta, term meta, selected option values, known SEO/social image metadata, and supported Bricks, Divi, and Beaver Builder saved data. Candidate values are validated before a reference is reported. Site Audit Summary Run an explicit bounded audit of up to 100 recent Media Library items to review referenced items, potential-unused review results, file-health issues, broken local uploads URLs, and exact duplicate groups. Support The Help tab includes an explicit support form for bug reports, feature requests, and questions. Nothing is sent until an administrator submits the form. The message and reply email are sent through the site's configured WordPress mail system to plugin support. Privacy Media Reference Inspector does not send media or site data to analytics or telemetry services and stores no scan history. Short-lived scan-status cache data stays in WordPress. The Help support form sends a message only after an administrator explicitly submits it.

2.4.1

• Added five polished, privacy-safe WordPress.org screenshots using real plugin admin UI.
• Added matching screenshot captions for Scanner, Bulk Scan, Page Audit, Help, and Broken URLs.
• Preserved all 2.4.0 scanner behavior; this is a directory presentation maintenance release.

2.4.0

• Added Media Impact Preview for already-computed single-scan results.
• Added bounded generic media-like post meta, term meta, and selected option validation.
• Added known Yoast SEO and Rank Math social-image metadata checks.
• Added modular Bricks, Divi, and Beaver Builder saved-media checks with value validation.
• Improved Media Library cached reference counts and explicit re-scan wording.
• Added a bounded manual Site Audit Summary for up to 100 recent media items.
• Added JSON export alongside CSV and printable HTML reports.
• Added 2.4 NEW badges and updated What’s New guidance.
• Added a one-time WordPress admin What’s New notice for existing installs after updating to 2.4.0.
• Updated compatibility metadata and validation for WordPress 7.1.
• Removed corrupt legacy WordPress.org screenshot assets so broken screenshots are no longer served.
• Revalidated WordPress.org banner sources for stable asset re-sync.
• Preserved read-only behavior and added stricter bounds to new metadata queries.

2.3.0

• Added reference confidence, source-category, and context metadata for supported scan results.
• Added integration coverage status for WordPress Core, WooCommerce, Elementor, and ACF.
• Added a bounded Broken URLs scanner for missing local uploads files referenced in post content or excerpts.
• Added short-lived local scan-status caching for on-demand Media Library reference status.
• Added selected attachment-ID support to Bulk Scan.
• Added Bulk Scan evidence/source and file-health filtering.
• Added a printable HTML audit report alongside the existing CSV export.
• Preserved existing Scanner, Page Audit, Duplicate Finder, support form, responsive UI, and read-only safety behavior.

2.2.0

• Added per-user NEW badges and a What's New card that disappear after the new feature tabs are visited.
• Added Page & Post Media Audit with supported media listing, broken attachment-ID review, and file-health status.
• Added Media File Health to single-item scan results.
• Added a bounded exact Duplicate Finder for recent readable local files.
• Added confirmed ACF Image, File, and Gallery field reference detection when ACF is active.
• Added Bulk Scan result sorting and clearer Potential unused review wording.
• Removed the temporary Diagnostics tab now that normal WordPress.org updates ar verified.
• Rebuilt Bulk Scan controls for responsive desktop, tablet, and mobile layouts, including desktop-sized mobile viewports.
• Added an explicit Help-tab support email form for bug reports, feature requests, and general questions.
• Added nonce, capability, sanitization, rate-limit, and mail-delivery feedback protections to the support form.
• Preserved all 2.1.0 scanner, integration, CSV, and read-only behavior.

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 in the 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.