{"id":359768,"date":"2026-09-24T08:24:48","date_gmt":"2026-09-24T08:24:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/unused-media-finder-cleaner\/"},"modified":"2026-09-24T08:24:34","modified_gmt":"2026-09-24T08:24:34","slug":"codecaste-unused-media-usage-audit","status":"publish","type":"plugin","link":"https:\/\/bcc.wordpress.org\/plugins\/codecaste-unused-media-usage-audit\/","author":15832969,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.1","stable_tag":"1.3.1","tested":"7.1.2","requires":"5.6","requires_php":"7.4","requires_plugins":null,"header_name":"Unused Media Usage Audit by CodeCaste","header_author":"Code Caste","header_description":"Safely identifies potentially unused images in the WordPress Media Library by scanning posts, meta, ACF, WooCommerce, Elementor, and widgets to compile a reference index.","assets_banners_color":"","last_updated":"2026-09-24 08:24:34","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.codecaste.com\/product\/codecaste-unused-media-usage-audit\/","header_author_uri":"https:\/\/codecaste.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":56,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.3.1":{"tag":"1.3.1","author":"codecaste","date":"2026-09-24 08:24:34","revision":3710843}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3711056,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3711056,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.3.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3710843,"resolution":"1","location":"assets","locale":"","width":2128,"height":1672}},"screenshots":{"1":"Dashboard showing scan status, media counts, and potentially unused files ready for review."}},"plugin_section":[],"plugin_tags":[8533,3786,163,84,219749],"plugin_category":[50],"plugin_contributors":[282440],"plugin_business_model":[],"class_list":["post-359768","plugin","type-plugin","status-publish","hentry","plugin_tags-audit","plugin_tags-cleanup","plugin_tags-images","plugin_tags-media","plugin_tags-unused-media","plugin_category-media","plugin_contributors-codecaste","plugin_committers-codecaste"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/codecaste-unused-media-usage-audit\/assets\/icon-128x128.png?rev=3711056","icon_2x":"https:\/\/ps.w.org\/codecaste-unused-media-usage-audit\/assets\/icon-256x256.png?rev=3711056","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/codecaste-unused-media-usage-audit\/assets\/screenshot-1.png?rev=3710843","caption":"Dashboard showing scan status, media counts, and potentially unused files ready for review."}],"raw_content":"<!--section=description-->\n<p>The plugin scans WordPress data, builds a reference index, and lists attachments for which no supported reference was found.<\/p>\n\n<p>Supported sources include:\n* Post content, blocks, shortcodes, lazy-load data, and <code>srcset<\/code>\n* Post meta, custom fields, ACF, and SCF data\n* Elementor data\n* WooCommerce product images and galleries\n* Options, widgets, term meta, and user meta\n* Active\/parent theme PHP, CSS, and JavaScript files\n* Eligible custom database tables\n* Developer-registered custom scanners<\/p>\n\n<p>Dashboard: <strong>Tools -&gt; Unused Media<\/strong><\/p>\n\n<h3>Safety<\/h3>\n\n<ul>\n<li>No automatic deletion.<\/li>\n<li>Results are <strong>Potentially Unused<\/strong>, not guaranteed unused.<\/li>\n<li>A final reference check runs before deletion.<\/li>\n<li>Full scans run in background batches.<\/li>\n<li>Targeted re-scans can run after site changes.<\/li>\n<\/ul>\n\n<h3>How It Works<\/h3>\n\n<p>After activation, a background scan starts automatically. The plugin indexes detected references and classifies attachments as <strong>In Use<\/strong> or <strong>Potentially Unused<\/strong>.<\/p>\n\n<p>The dashboard shows scan status, logs, scan time, and results. Use <strong>Run Full Scan<\/strong> for a complete rescan.<\/p>\n\n<p>If WP-Cron is unreliable, configure server cron for <code>wp-cron.php<\/code> or keep the dashboard open during scanning.<\/p>\n\n<h3>Results<\/h3>\n\n<p>The dashboard includes search, filtering, list\/grid views, attachment details, and Media Library links.<\/p>\n\n<p>You can delete individual files, selected files, or all files matching the current filters.<\/p>\n\n<p>WordPress's standard attachment deletion API is used.<\/p>\n\n<h3>Limitations<\/h3>\n\n<p>Detection is not guaranteed for:\n* Dynamically generated URLs\n* External APIs or remote services\n* Some CDN\/offloaded media\n* Plugin source files and unsupported filesystem locations\n* Unsupported custom database formats\n* Some numeric attachment IDs\n* WordPress Multisite, which is not currently verified<\/p>\n\n<p>Always review files before deleting them, especially on sites using CDNs, offloaded media, or third-party integrations.<\/p>\n\n<h3>Developer Extension<\/h3>\n\n<p>Developers can add custom scanners using the\n    media_cleanup_scout_additional_reference_sources filter.<\/p>\n\n<h3>Data<\/h3>\n\n<p>The plugin stores its scan index, results, logs, settings, and scan state in plugin-managed data.<\/p>\n\n<p>Deactivation clears scan data and scheduled jobs. Uninstalling removes plugin-managed data and settings.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate it from <strong>Plugins<\/strong>.<\/li>\n<li>Open <strong>Tools -&gt; Unused Media<\/strong>.<\/li>\n<li>Review the results after the first scan.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20a%20file%20guaranteed%20to%20be%20unused%3F\"><h3>Is a file guaranteed to be unused?<\/h3><\/dt>\n<dd><p>No. Dynamic or unsupported references may not be detected.<\/p><\/dd>\n<dt id=\"does%20it%20support%20acf%2C%20scf%2C%20elementor%2C%20and%20woocommerce%3F\"><h3>Does it support ACF, SCF, Elementor, and WooCommerce?<\/h3><\/dt>\n<dd><p>Yes, supported media references from these systems are scanned.<\/p><\/dd>\n<dt id=\"does%20it%20scan%20theme%20files%3F\"><h3>Does it scan theme files?<\/h3><\/dt>\n<dd><p>Yes. The active theme and applicable parent theme are checked for literal uploads-path references.<\/p><\/dd>\n<dt id=\"does%20it%20scan%20custom%20database%20tables%3F\"><h3>Does it scan custom database tables?<\/h3><\/dt>\n<dd><p>Yes, when detectable local uploads-path references are present in supported tables.<\/p><\/dd>\n<dt id=\"what%20if%20wp-cron%20is%20disabled%3F\"><h3>What if WP-Cron is disabled?<\/h3><\/dt>\n<dd><p>Use a server cron job or keep the dashboard open during the scan.<\/p><\/dd>\n<dt id=\"can%20a%20used%20file%20appear%20as%20unused%3F\"><h3>Can a used file appear as unused?<\/h3><\/dt>\n<dd><p>Yes. This can happen with dynamic PHP\/JavaScript URLs, external services, CDN\/offloaded media, or unsupported database formats.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Updated plugin URI, version, and documentation.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Rebranded to <strong>Unused Media Usage Audit by CodeCaste<\/strong>.<\/li>\n<li>Updated slug\/text domain and internal prefixes.<\/li>\n<li>Fresh scan\/settings state after upgrade.<\/li>\n<\/ul>\n\n<h4>1.2.3<\/h4>\n\n<ul>\n<li>Improved WordPress.org compliance and settings migration.<\/li>\n<li>Moved dashboard to <strong>Tools -&gt; Unused Media<\/strong>.<\/li>\n<\/ul>\n\n<h4>1.2.2<\/h4>\n\n<ul>\n<li>Added scan-recency and WP-Cron notices.<\/li>\n<li>Added WooCommerce gallery change detection.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Improved security, performance, concurrency, and scan coverage.<\/li>\n<li>Added custom scanner support and cleanup improvements.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<\/ul>","raw_excerpt":"Find potentially unused Media Library files and safely review them before deletion.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/359768","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=359768"}],"author":[{"embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/codecaste"}],"wp:attachment":[{"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=359768"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=359768"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=359768"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=359768"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=359768"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bcc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=359768"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}