Title: ProgMaze Media Scanner Author: ProgMaze Published: May 3, 2026 Last modified: May 3, 2026 --- Search plugins ![](https://ps.w.org/progmaze-media-scanner/assets/banner-772x250.png?rev=3521471) ![](https://ps.w.org/progmaze-media-scanner/assets/icon-128x128.png?rev=3521471) # ProgMaze Media Scanner By [ProgMaze](https://profiles.wordpress.org/progmaze/) [Download](https://downloads.wordpress.org/plugin/progmaze-media-scanner.1.0.0.zip) * [Details](https://wordpress.org/plugins/progmaze-media-scanner/#description) * [Reviews](https://wordpress.org/plugins/progmaze-media-scanner/#reviews) * [Installation](https://wordpress.org/plugins/progmaze-media-scanner/#installation) * [Development](https://wordpress.org/plugins/progmaze-media-scanner/#developers) [Support](https://wordpress.org/support/plugin/progmaze-media-scanner/) ## Description Need to know which posts, builders, or meta fields still reference an image—or which uploads are safe to remove? **ProgMaze Media Scanner** runs a **deep scan** of your site: it walks public post types (including templates), reads `post_content` and `post_meta`, parses Gutenberg- style block data, URLs, featured images, and nested serialized or JSON values so you get a clear picture of **where each file is used** and what is **unused**. #### Key Features * **Full site scan** — Scans all post types, pages, custom post types, templates, and reusable blocks. * **Gutenberg aware** — Parses block JSON attributes (core/image, core/gallery, core/cover, core/video, core/file, core/media-text, and more) to find media IDs. * **Page builder support** — Scans media used in Gutenberg, Avada, Elementor, and similar setups that store IDs or URLs in content or meta. * **Featured image tracking** — Detects when a media item is used as a featured image on any post or custom post type. * **Post meta scanning** — Finds media in ACF fields, WooCommerce product galleries, and other plugins that store attachment IDs or URLs in meta. * **Usage detail view** — Open any item to see every post that uses it, with Edit and View links and usage type (content, featured image, meta, gallery, setting). * **Safe deletion** — Only unused media can be deleted directly; used items can be detached first or removed with **Detach & Delete**. * **Bulk delete** — Remove multiple unused items in one action. * **Incremental updates** — Saving a post re-scans that post only, keeping the cache fresh without a full rescan. * **Filters** — All / Used / Unused, mime type filters, and search by filename. * **Library overview** — On the main screen: total storage, image vs non-image space, space by file type (bars), largest uploads, and most-referenced media ( cached for performance). #### Supported for * WordPress Gutenberg (core blocks) * Elementor * Avada * ACF (Advanced Custom Fields) * WooCommerce (featured image + gallery) * Builders that store media URLs or IDs in `post_content` or `post_meta` ### How it works When you run **Scan All Media**, the plugin rebuilds its usage cache: it inspects content and meta for attachment IDs, upload URLs, `_thumbnail_id`, WooCommerce galleries, and nested structures. Each link is stored with a usage type. Saving a post triggers a targeted re-scan for that post only. On **Media ProgMaze Media Scanner**, filter by used or unused, narrow by type, search by filename, use **View Usage** for details, and delete or **Detach & Delete** as needed. Deletions are permanent—back up first. ## Installation 1. Upload the `progmaze-media-scanner` folder to `/wp-content/plugins/` (or upload the ZIP in WP Admin). 2. Activate the plugin through the **Plugins** menu in WordPress. 3. Go to **Media ProgMaze Media Scanner** in your admin menu. 4. Click **Scan All Media** to run the first full scan. ## FAQ ### Does this slow down my site? No. The scan runs when you click **Scan All Media** or when a post is saved—not on normal front-end views. ### How accurate is the detection? Very accurate for typical WordPress setups and the integrations listed above. Custom storage patterns may need manual judgment. ### What happens when I click “Detach & Delete”? Featured image references are cleared, `post_parent` is detached, usage rows are removed, then the attachment is permanently deleted. ### Can I undo a deletion? No. Back up before bulk deletes. ### Is it compatible with multisite? Single-site tested; multisite is planned for a future release. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “ProgMaze Media Scanner” is open source software. The following people have contributed to this plugin. Contributors * [ ProgMaze ](https://profiles.wordpress.org/progmaze/) * [ Muhammad Zaki ](https://profiles.wordpress.org/wpvirtuoso/) * [ Muhammad Umar ](https://profiles.wordpress.org/ranaumar7899/) [Translate “ProgMaze Media Scanner” into your language.](https://translate.wordpress.org/projects/wp-plugins/progmaze-media-scanner) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/progmaze-media-scanner/), check out the [SVN repository](https://plugins.svn.wordpress.org/progmaze-media-scanner/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/progmaze-media-scanner/) by [RSS](https://plugins.trac.wordpress.org/log/progmaze-media-scanner/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release as **ProgMaze Media Scanner** (distinct from other “media tracker” plugins; internal code prefixes unchanged). ## Meta * Version **1.0.0** * Last updated **4 days ago** * Active installations **Fewer than 10** * WordPress version ** 5.8 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Tags * [gutenberg](https://wordpress.org/plugins/tags/gutenberg/)[images](https://wordpress.org/plugins/tags/images/) [media](https://wordpress.org/plugins/tags/media/)[media library](https://wordpress.org/plugins/tags/media-library/) [optimization](https://wordpress.org/plugins/tags/optimization/) * [Advanced View](https://wordpress.org/plugins/progmaze-media-scanner/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/progmaze-media-scanner/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/progmaze-media-scanner/reviews/) ## Contributors * [ ProgMaze ](https://profiles.wordpress.org/progmaze/) * [ Muhammad Zaki ](https://profiles.wordpress.org/wpvirtuoso/) * [ Muhammad Umar ](https://profiles.wordpress.org/ranaumar7899/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/progmaze-media-scanner/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://progmaze.com/)