Title: MediaXray Author: Usman S. Published: October 19, 2026 Last modified: October 20, 2026 --- Search plugins ![](https://ps.w.org/mediaxray/assets/banner-772x250.png?rev=3755611) ![](https://ps.w.org/mediaxray/assets/icon-256x256.png?rev=3755611) # MediaXray By [Usman S.](https://profiles.wordpress.org/fixitusman/) [Download](https://downloads.wordpress.org/plugin/mediaxray.1.0.2.zip) * [Details](https://wordpress.org/plugins/mediaxray/#description) * [Reviews](https://wordpress.org/plugins/mediaxray/#reviews) * [Installation](https://wordpress.org/plugins/mediaxray/#installation) * [Development](https://wordpress.org/plugins/mediaxray/#developers) [Support](https://wordpress.org/support/plugin/mediaxray/) ## Description #### What makes MediaXray different Most media cleaners give you a yes/no “unused” list. MediaXray builds a full usage map first and treats deletion as the last, reversible step: * **Counts every single use, not just “used / unused”.** Each occurrence is recorded with the page, product, template or setting it is in, and the exact block, widget, breakpoint or field that uses it. * **Understands Elementor at widget level.** Image widgets, container backgrounds on every breakpoint, overlays, carousels, dynamic tags, the Global Kit and Theme Builder display conditions (a header shown site-wide makes its logo Global). * **Four statuses instead of two.** Used, Global (protected), Needs check (not on any live page: only drafts, saved templates, inactive themes, unclear matches) and Unused, so “no reference found” never silently becomes “delete”. * **Independent deep verification before cleanup.** A brute-force search of the raw database and the active theme’s files double-checks every file before it can be removed. * **Restorable quarantine.** Files (including WebP/AVIF copies) are moved out of reach, not deleted, so you can check your site and restore with one click. * **Built for big sites.** Resumable batched scans, an index that updates itself as content changes, and WP-CLI commands. MediaXray answers two questions, in this order: 1. **Where is this file used?** Every individual reference, grouped by page, product, template or setting, with the widget, block or field that uses it. 2. **Is it safe to remove?** Only after the first question is answered, and only after an independent deep verification. #### Statuses * **Used** — confirmed references in live (published or private) content. * **Global** — logo, site icon, active theme settings, Theme Builder templates shown site-wide, Elementor Global Kit, active widgets. Protected from cleanup. * **Needs check** — not on any live page: only referenced by drafts, unassigned templates, inactive themes or widgets, Elementor’s stored fallback HTML, or uncertain matches. * **Unused** — no reference found by any supported source. #### How references are counted * A reference is one individual use. The same image twice on a page is 2 references on 1 page. * One image tag with its srcset, wp-image class and a link to its full size is 1 reference. * Unique content counts each page, product, template, term or setting once. #### What is scanned * All content types (pages, posts, products, custom post types, Elementor templates, block templates, reusable blocks) in every status except Trash. * Gutenberg blocks (block-aware), classic HTML, galleries and shortcodes, featured images, excerpts. * Elementor: every widget and container — images, backgrounds on every breakpoint, overlays, galleries and carousels, video, links, dynamic tags, page and Global Kit settings, Theme Builder display conditions, embedded templates, atomic elements. * WooCommerce: product images, galleries, variation images (shown on the parent product), category images, downloadable files. * ACF fields (field-type aware when ACF is active), all custom fields, term and user meta, comments, widgets, Customizer, site icon and logo, Yoast SEO images and plugin settings. #### Safe cleanup * Deep verification searches the raw database and the active theme’s files for every file name and ID pattern of the attachment, independently of the parsers. * Quarantine moves all files of an attachment (including WebP/AVIF copies made by converter plugins) into a protected folder and hides it from the Media Library. One click restores it. * Permanent deletion only works on quarantined items and requires typing DELETE. * Uninstalling the plugin restores everything that is still in quarantine. #### Built for large sites Scans run in short, resumable batches, keep the previous results visible until the new scan is complete, and the index updates itself when content, terms, uploads or settings change. WP-CLI: `wp mediaxray scan`, `status`, `list`, `usage `,` verify `. #### Privacy MediaXray makes no external requests, sends no data anywhere and adds no tracking. All analysis happens in your own database. ## Screenshots [⌊Overview: status totals, scan progress and the media usage list.⌉⌊Overview: status totals, scan progress and the media usage list.⌉[ Overview: status totals, scan progress and the media usage list. [⌊Usage details: every reference grouped by page, template and setting.⌉⌊Usage details: every reference grouped by page, template and setting.⌉[ Usage details: every reference grouped by page, template and setting. [⌊Quarantine: restore or permanently delete reviewed files.⌉⌊Quarantine: restore or permanently delete reviewed files.⌉[ Quarantine: restore or permanently delete reviewed files. [⌊Media Library integration: usage column and attachment details panel.⌉⌊Media Library integration: usage column and attachment details panel.⌉[ Media Library integration: usage column and attachment details panel. ## Installation 1. Upload the plugin through Plugins Add New Upload Plugin, or install it from the plugin directory. 2. Activate it. 3. Go to Media MediaXray and click Start scan. ## FAQ ### Will it delete anything automatically? No. Nothing is ever deleted automatically. Unused files are only moved to quarantine when you choose to, after a fresh deep verification, and you can restore them at any time. ### Why is a file marked Needs check instead of Unused? Something still mentions it, but not in live content — for example a draft, a saved Elementor template that is not placed anywhere, an inactive theme’s settings, or Elementor’s stored fallback copy of a page. Open the file’s usage details to see exactly where. ### Can it detect every possible use? No tool can. Files referenced only from PHP code outside the active theme, external websites, JavaScript-built URLs or plugins that keep their own database tables cannot be detected. That is why cleanup goes through quarantine: check your site, then delete. ### Does it work with page caches and CDNs? Yes. File URLs on other hosts (CDNs) are matched by their uploads path, and MediaXray’s own admin requests opt out of page caching. ## Reviews ![](https://secure.gravatar.com/avatar/d200441ba24d3e95892a8570089c449711ef61cbc4628b74deb203cae52a11da? s=60&d=retro&r=g) ### 󠀁[Best Plugin For Removing Unused Media](https://wordpress.org/support/topic/best-plugin-for-removing-unused-media/)󠁿 [abmoiz39](https://profiles.wordpress.org/abmoiz39/) October 20, 2026 Such a perfect plugin i find for use in my project. It keeps help me to remove unused images in my media that is very tough to do manually. [ Read all 1 review ](https://wordpress.org/support/plugin/mediaxray/reviews/) ## Contributors & Developers “MediaXray” is open source software. The following people have contributed to this plugin. Contributors * [ Usman S. ](https://profiles.wordpress.org/fixitusman/) [Translate “MediaXray” into your language.](https://translate.wordpress.org/projects/wp-plugins/mediaxray) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/mediaxray/), check out the [SVN repository](https://plugins.svn.wordpress.org/mediaxray/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/mediaxray/) by [RSS](https://plugins.trac.wordpress.org/log/mediaxray/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.2 * “Review” is now called “Needs check”, with a plainer explanation and a shortcut from the dashboard. * Quarantine has a single delete action: choose Delete permanently, then confirm by typing DELETE. * Links to pages and templates open the normal WordPress edit screen. #### 1.0.1 * New dashboard panel: scan button, live step-by-step progress and status cards in one place. * Shows how much disk space unused media takes up. * WordPress notices now appear at the top of the screen, above the MediaXray panel. * Added the standard “View details” link on the Plugins screen. * Refreshed tabs, cards and table styling. #### 1.0.0 * First release. ## Meta * Version **1.0.2** * Last updated **9 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Tags * [delete unused media](https://wordpress.org/plugins/tags/delete-unused-media/) [image usage](https://wordpress.org/plugins/tags/image-usage/)[media cleanup](https://wordpress.org/plugins/tags/media-cleanup/) [media library](https://wordpress.org/plugins/tags/media-library/)[unused images](https://wordpress.org/plugins/tags/unused-images/) * [Advanced View](https://wordpress.org/plugins/mediaxray/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/mediaxray/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/mediaxray/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/mediaxray/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/mediaxray/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/mediaxray/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/mediaxray/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/mediaxray/reviews/) ## Contributors * [ Usman S. ](https://profiles.wordpress.org/fixitusman/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/mediaxray/)