System Status tab added. Scanner now shows a clear "No Unused Files Found" message for clean sites. Page builders correctly shown as free features.<\/p>","1.4.1":"
Security and reliability improvements. Upgrade prompts and the artificial usage meter have been removed. Advanced features are now shown as "Coming Soon" previews.<\/p>","1.0.0":"
First release. After activation run a full scan to audit your media library.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3560164,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3560164,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3560164,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3560164,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.5","1.4.6"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3560164,"resolution":"1","location":"assets","locale":"","width":1920,"height":1080},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3560164,"resolution":"2","location":"assets","locale":"","width":997,"height":561},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3560164,"resolution":"3","location":"assets","locale":"","width":1920,"height":1080},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3560164,"resolution":"4","location":"assets","locale":"","width":1920,"height":1081}},"screenshots":{"1":"Dashboard<\/strong> \u2014 stat cards (total media, unused files, storage used, potential savings), storage breakdown by type, last-scan date, and quick action buttons.","2":"Scanner \u2014 Pre-scan state<\/strong> \u2014 clear \"Start Full Scan\" call-to-action with source badges showing what will be scanned.","3":"Scanner \u2014 Results<\/strong> \u2014 media rows with thumbnail, filename, file size, \"Used In\" post links, type filter, Export CSV, and bulk-action toolbar.","4":"Recovery tab<\/strong> \u2014 trashed files with one-click restore per file and bulk restore\/delete options.","5":"Duplicates tab<\/strong> \u2014 duplicate groups showing each copy, total wasted space, and \"Coming Soon\" card for one-click merge.","6":"Settings<\/strong> \u2014 recent-upload protection days, trash retention days, WooCommerce toggle, and file-type exclusions.","7":"Folders tab<\/strong> \u2014 virtual folder organizer preview with \"Coming Soon\" card."}},"plugin_section":[],"plugin_tags":[3786,29823,84,2216,17749],"plugin_category":[50],"plugin_contributors":[265719],"plugin_business_model":[],"class_list":["post-304695","plugin","type-plugin","status-publish","hentry","plugin_tags-cleanup","plugin_tags-duplicates","plugin_tags-media","plugin_tags-storage","plugin_tags-unused","plugin_category-media","plugin_contributors-naqeeb026","plugin_committers-naqeeb026"],"banners":{"banner":"https:\/\/ps.w.org\/media-purge\/assets\/banner-772x250.png?rev=3560164","banner_2x":"https:\/\/ps.w.org\/media-purge\/assets\/banner-1544x500.png?rev=3560164","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/media-purge\/assets\/icon-128x128.png?rev=3560164","icon_2x":"https:\/\/ps.w.org\/media-purge\/assets\/icon-256x256.png?rev=3560164","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/media-purge\/assets\/screenshot-1.png?rev=3560164","caption":"Dashboard<\/strong> \u2014 stat cards (total media, unused files, storage used, potential savings), storage breakdown by type, last-scan date, and quick action buttons."},{"src":"https:\/\/ps.w.org\/media-purge\/assets\/screenshot-2.png?rev=3560164","caption":"Scanner \u2014 Pre-scan state<\/strong> \u2014 clear \"Start Full Scan\" call-to-action with source badges showing what will be scanned."},{"src":"https:\/\/ps.w.org\/media-purge\/assets\/screenshot-3.png?rev=3560164","caption":"Scanner \u2014 Results<\/strong> \u2014 media rows with thumbnail, filename, file size, \"Used In\" post links, type filter, Export CSV, and bulk-action toolbar."},{"src":"https:\/\/ps.w.org\/media-purge\/assets\/screenshot-4.png?rev=3560164","caption":"Recovery tab<\/strong> \u2014 trashed files with one-click restore per file and bulk restore\/delete options."}],"raw_content":"\n Media Purge<\/strong> gives you complete visibility into your WordPress media library, surfaces every file that is not used anywhere on your site, and lets you clean it up safely \u2014 without any risk of breaking live content.<\/p>\n\n Whether you have a small blog or a large WooCommerce store, media libraries accumulate hundreds of forgotten files over time. Media Purge makes it effortless to spot them, verify whether they are truly unused, and move them to a recoverable trash \u2014 not a permanent delete.<\/p>\n\n Free to use.<\/strong> All core cleanup features are available at no cost \u2014 scan, review, trash, restore, export. No scan limits, no file caps. A paid upgrade tier with advanced automation features is planned for a future release; those features are clearly marked \"Coming Soon\" inside the plugin.<\/p>\n\n Smart Unused Media Scanner<\/strong>\nScans post content, post meta (featured images, WooCommerce product galleries), theme customizer options, widget areas, and all major page builder data (Elementor, Divi, WPBakery, Beaver Builder). Results show the exact file size so you know how much storage you will reclaim.<\/p>\n\n \"Used In\" Display<\/strong>\nEach media item shows exactly where it is used \u2014 post title, post type, and context (e.g. Featured Image in \"About Us\", Elementor widget in \"Home\") \u2014 with a direct link to edit that post. Never accidentally delete a file that is still in use.<\/p>\n\n Safe Trash Flow<\/strong>\nFiles are moved to an internal trash, not permanently deleted. By default they remain recoverable for 30 days. The retention window is adjustable in Settings.<\/p>\n\n Recovery Tab<\/strong>\nBrowse all trashed media, restore individual files to your live library in one click, or bulk-restore. Permanently delete only when you are ready.<\/p>\n\n Storage Analytics Dashboard<\/strong>\nSee a visual breakdown of your total media storage by file type (Images \/ Videos \/ Audio \/ Documents \/ Other) with colour-coded segments. At-a-glance stats show total media count, total unused count, total storage size, and potential savings.<\/p>\n\n Duplicate Detection (View)<\/strong>\nAutomatically groups files that are byte-for-byte identical using MD5 hashing. See every duplicate group with its total wasted storage. One-click duplicate merge is coming in a future release.<\/p>\n\n Type Filter & CSV Export<\/strong>\nFilter unused media by file type in one click. Export the full unused media list to CSV for offline review or reporting.<\/p>\n\n Pagination & Bulk Actions<\/strong>\nHandles large libraries with 30-items-per-page load-more pagination. Bulk select, bulk trash, and bulk whitelist any number of files at once.<\/p>\n\n Whitelist<\/strong>\nFiles can be whitelisted so the scanner never flags them again, even if no URL reference is found.<\/p>\n\n Page Builder Support (Free)<\/strong>\nDeep scanning of Elementor JSON data, Divi page meta, WPBakery shortcodes, and Beaver Builder layout data.<\/p>\n\n The following features are currently in development and will be part of a paid upgrade tier<\/strong>. They are clearly labelled \"Coming Soon\" inside the plugin.<\/p>\n\n Core cleanup (scan \u2192 review \u2192 trash \u2192 restore) will always be free.<\/p>\n\n WordPress:<\/strong> 5.8 or higher (tested up to 6.7).\nPHP:<\/strong> 7.4 or higher.\nMultisite:<\/strong> single-site installs only (multisite support is planned).<\/p>\n\n\n\n\n Plugin \/ Theme\n What is scanned\n\n\n\n\n Elementor<\/strong>\n All image widgets, background images, and gallery elements inside Elementor JSON data\n\n\n Divi Builder<\/strong> (plugin or theme)\n Images embedded in Divi module meta and layout data\n\n\n WPBakery Page Builder<\/strong>\n Images referenced inside No \u2014 not automatically, and not until you choose to. Files are moved to the plugin's internal trash first. They remain there for 30 days by default (adjustable in Settings) and can be restored at any time from the Recovery<\/strong> tab. Permanent deletion only happens when you click \"Delete Permanently\" yourself, or when the retention period expires.<\/p><\/dd>\n Yes. The scanner is completely read-only \u2014 it never moves, modifies, or deletes anything while scanning. Nothing changes on your site until you explicitly click a Trash button.<\/p><\/dd>\n Yes. Elementor, Divi, WPBakery, and Beaver Builder are all scanned automatically. For unsupported builders, use the Whitelist<\/strong> feature to exclude files you know are in use.<\/p><\/dd>\n Use the Whitelist<\/strong> feature. Click \"Keep\" on any file in the Scanner tab to permanently exclude it from all future scan results.<\/p><\/dd>\n Yes. Product featured images and image galleries are scanned via post meta inspection.<\/p><\/dd>\n Files are grouped by their MD5 hash. Byte-for-byte identical files are placed in the same duplicate group regardless of filename.<\/p><\/dd>\n No. Scans run as a background async process \u2014 normal visitors are unaffected even while a scan is in progress.<\/p><\/dd>\n Yes. Use the Export CSV<\/strong> button in the Scanner tab.<\/p><\/dd>\n Cron events are cleared immediately. Plugin database tables are left intact so your scan history and whitelist are preserved if you reactivate.<\/p><\/dd>\n Database tables and all plugin options are fully removed.<\/p><\/dd>\n No artificial limits. There are no scan caps, no file-count restrictions, and no time limits. All core features are fully available at no cost.<\/p><\/dd>\n\n<\/dl>\n\n\nFree Features<\/h3>\n\n
Features Coming in a Future Release<\/h3>\n\n
\n
Who Is This For?<\/h3>\n\n
\n
Compatibility<\/h3>\n\n
[vc_*]<\/code> shortcode attributes\n\n\n Beaver Builder<\/strong>\n Images stored in Beaver Builder layout posts\n\n\n WooCommerce<\/strong>\n Product featured image and all product gallery images\n\n\n Gutenberg \/ Block Editor<\/strong>\n Image, gallery, cover, media-text, and all core blocks that store attachment IDs\n\n\n Classic Editor<\/strong>\n All <img><\/code> tags and [gallery]<\/code> shortcodes in post content\n\n\n Widgets & Theme Customizer<\/strong>\n Any upload URLs stored in widget options or theme mod values\n\n\n\n
media-purge<\/code> folder to \/wp-content\/plugins\/<\/code>\nor<\/strong> install directly via WordPress \u2192 Plugins \u2192 Add New \u2192 search \"Media Purge\".<\/li>\n\n
Will it permanently delete my files?<\/h3><\/dt>\n
Is it safe on live sites?<\/h3><\/dt>\n
Does it work with page builders?<\/h3><\/dt>\n
What if a file is used by a theme or plugin the scanner doesn't know about?<\/h3><\/dt>\n
Does it work with WooCommerce?<\/h3><\/dt>\n
How does duplicate detection work?<\/h3><\/dt>\n
Will activating the plugin affect my site's performance?<\/h3><\/dt>\n
Can I export the list of unused files?<\/h3><\/dt>\n
What happens if I deactivate the plugin?<\/h3><\/dt>\n
What happens if I uninstall the plugin?<\/h3><\/dt>\n
Does the free version have any limits?<\/h3><\/dt>\n
1.4.6<\/h4>\n\n
\n
1.4.5<\/h4>\n\n
\n
1.4.4<\/h4>\n\n
\n
1.4.3<\/h4>\n\n
\n
GET \/wpmp\/v1\/health<\/code><\/li>\n1.4.2<\/h4>\n\n
\n
1.4.1<\/h4>\n\n
\n
get_unused_media<\/code> query to use $wpdb->prepare()<\/code> \u2014 eliminated SQL LIKE injection risk.<\/li>\n?page=0<\/code> was passed to the media endpoint.<\/li>\nPOST \/scan\/cancel<\/code> REST endpoint to force-clear a stuck scan lock.<\/li>\nreset_monthly_count()<\/code> cron method.<\/li>\n<\/ul>\n\n1.3.0<\/h4>\n\n
\n
1.2.0<\/h4>\n\n
\n
1.1.0<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n