https://www.gpldownloads.com/downloads/media-cleaner-pro/changelog/
Black Friday Month

33% off all membership plans Excludes the Developers plan

See plans
Latest Updates
Back to Media Cleaner Pro

Media Cleaner Pro changelog

Release notes for every version we have on record, newest first.

Latest 7.3.6 · 3 Nov 2026 40 versions Since Mar 2025

2026 27 versions

7.3.6 Latest 3 Nov 2026 3 new1 improved
New
  • Duplicate scan now finds visually similar images using perceptual hashing (dHash), with a sensitivity setting.
  • Comparison tool to view duplicates side by side before deleting them.
  • Support for BeBuilder.
Improved
  • Error modals now include a link to the related documentation.
7.3.5 30 Oct 2026 5 new5 improved2 fixed
New
  • Storage page showing where the site's space goes and what can be cleaned.
  • Parser for Eventin.
  • The free version now shows how many files in the uploads folder are not in the Media Library.
  • Warning when a scan lists a large share of the Media Library, and one extra confirmation before Delete All.
  • Option to list the original files kept next to scaled images.
Improved
  • Optimize Thumbnails now keeps the sizes your theme or plugins still register.
  • The header shows the installed version, and how to update or renew when a newer one is available.
  • Settings is now the wrench at the end of the header.
  • Meow Apps → Media Cleaner now opens the Dashboard, and the Storage page has a proper title.
  • Tidied the advanced tools, Reset Options now asks for confirmation, and results coming from another scan method are clearer.
Fixed
  • Cleaning a media entry no longer moves or deletes files that another attachment still uses.
  • Invalid URLs and unclean text no longer block the whole scan.
7.3.4 24 Oct 2026 1 new4 improved1 fixed
New
  • Divi 4 parser now detects testimonial portrait images.
Improved
  • The scan's Finished dialog names the page builders only Pro can read, and clicking a locked scan method explains what Pro would do.
  • The Ignore button is now disabled instead of hidden when cleanup is not allowed.
  • Pro badges now link to the Media Cleaner page, and a Pro install that is not activated yet is shown as Pro.
  • Clearer License tab that explains Pro to free users and invites Pro buyers to activate.
Fixed
  • Old scans are now fully cleaned up, so the database tables no longer grow with every scan.
7.3.3 20 Oct 2026 3 fixed
Fixed
  • Images set in the Customizer are now detected in every theme's settings, so they are no longer flagged as unused.
  • Scans now run on SQLite installs such as WordPress Playground and Studio, and recovering a file no longer relies on MySQL-only SQL.
  • Closing a dropdown no longer drops the dashboard's colors.
7.3.2 19 Oct 2026 7 improved3 fixed
Improved
  • Scans now run many times faster by processing several batches per request.
  • Reworded the buffer settings and the overload hint, since a request now covers several batches instead of one.
  • The dashboard is calmer for first-time users.
  • The free version now names the page builders it cannot read and points to Pro.
  • The Free badge and logo in the plugin header now link to the Pro page.
  • Expired licenses now get a grace period with retries, license keys are normalized, and an Activate License notice was added.
  • Pro links inside Media Cleaner now indicate where they were clicked from.
Fixed
  • Start Over now works after an interrupted scan.
  • Scans are no longer interrupted when something triggers a redirect.
  • Results from a scan made with the free version no longer unlock deletions after switching to Pro.
7.3.1 10 Oct 2026 2 new1 improved2 fixed
New
  • A Scan button directly in the notice shown when deleting requires a new scan.
  • Hook tracing and reporting to analyze performance during long cleanup requests.
Improved
  • Scan error messages are clearer and suggest using smaller buffers and a delay when the server times out.
Fixed
  • Trash deletion now uses your file buffer setting instead of a placeholder value.
  • Timeouts during a scan are now handled by the scanner itself instead of surfacing as raw errors.
7.3.0 3 Oct 2026 3 improved1 fixed
Improved
  • Debug logs are now enabled by default; existing settings are kept.
  • Scans now skip the CSS posts generated by Jetpack Boost.
  • The time allowed per item now comes from PHP's own execution limit instead of a fixed 24 second budget.
Fixed
  • Cleanup and trash recovery no longer fail when the host alters file details, such as size or modification time, on its own.
7.2.9 26 Sep 2026 3 new3 improved5 fixed
New
  • Live Logs panel on the scan dashboard showing scan, trash and delete activity in real time.
  • Detailed timing and error tracking for the deletion process.
  • Log history linked to the support ID in the Support Bundles section.
Improved
  • Multilingual references are now resolved in their own scan step instead of during the references extraction.
  • Failed items during deletion are now grouped in a single summary instead of opening an error modal right away.
  • The license screen now explains the exact reason a license check failed.
Fixed
  • A server that cannot reach the license server no longer freezes the admin for minutes.
  • Temporary errors while processing a media file no longer cause an endless retry loop.
  • Attachment lookup for multilingual references is faster on large sites.
  • SiteOrigin Page Builder parser no longer registers the same reference several times.
  • Meta Box parser now collects term meta in the scan once step using the paged parser.
7.2.8 14 Sep 2026 1 fixed3 changed
Fixed
  • Resolved a PHP warning that could appear during scans.
Changed
  • 🎵 Discuss with others about Media Cleaner on the Discord.
  • 🌴 Keep us motivated with a little review here. Thank you!
  • 🥰 If you want to help us, check our Patreon. Thank you!
7.2.7 7 Sep 2026 3 new2 improved3 fixed
New
  • "Inspect" button for duplicates to compare and resolve issues from a unified view.
  • Unlock Scan maintenance tool.
  • Soliloquy parser.
Improved
  • SiteOrigin parser supports the gallery widget and extracts HTML content.
  • Divi parser handles base64-encoded JSON references.
Fixed
  • Duplicates scan skips unreadable files instead of stopping, and duplicates are no longer protected from checks.
  • Loading bar now completes on each batch.
  • Force Clean Trash handles the trash inventory and checks both physical and database leftovers.
7.2.6 17 Aug 2026 3 new1 improved2 fixed
New
  • Support for SiteOrigin Page Builder.
  • Auto Buffer helper that sets the advanced buffer value from server tests, with warnings for slow items.
  • Plugin board and AI site analysis to the dashboard.
Improved
  • Minimum PHP version is now 8.1.
Fixed
  • Query handling and logging for unbounded database queries.
  • MCP tools were initialised before the plugin load check.
7.2.5 25 Jul 2026 2 new2 improved1 fixed
New
  • Force Clean Trash option in the settings for trash items that cannot be removed normally.
  • Dashboard warning when the manifest contains unsafe entries.
Improved
  • Error messages for failed items are now grouped in scan results.
  • Files are marked as unsafe instead of aborting the scan when fingerprinting fails.
Fixed
  • Document size validation no longer stops scans, and the size limit is now configurable.
7.2.4 18 Jul 2026 1 improved1 fixed
Improved
  • Moved the unsupported plugins warning into the free version box as a compact note next to the Pro button.
Fixed
  • Stopped a single oversized media reference from aborting the whole scan.
7.2.3 16 Jul 2026 1 new3 improved4 fixed
New
  • Dashboard now shows a cleanup status message explaining when a fresh scan is needed.
Improved
  • Trash buttons are hidden while a scan is staged, preventing actions the server would refuse.
  • Trash previews are now restricted to raster images.
  • Deleting results from an older scanner version now requires a fresh scan first.
Fixed
  • Trash recovery no longer requires a scan — recovered files are always available regardless of scan state.
  • Background images set in the Site Editor are now detected during scans.
  • Hotfix — Results created before the scan-runs system are now properly adopted on update and reactivation, restoring cleanup and trash previews.
  • MCP trashing no longer deletes files when the trash setting is skipped, and no longer reports unsaved progress.
7.2.2 15 Jul 2026 2 new2 improved1 fixed
New
  • MCP tools so an AI assistant can scan, review and clean up through AI Engine
  • Parser for background images stored in core block attributes
Improved
  • Reworked the references view into four meaningful columns with media titles, missing media markers, and fixed post titles and thumbnails
  • Replaced the browser broken image icon with a placeholder when a thumbnail cannot be loaded
Fixed
  • References search returning no results because of an ambiguous column in the query
7.2.1 13 Jul 2026 1 fixed3 changed
Fixed
  • Hotfix — Restored shortcode analysis and lenient upload URL matching to fix false positives introduced in 7.2.0.
Changed
  • 🎵 Discuss with others about Media Cleaner on the Discord.
  • 🌴 Keep us motivated with a little review here. Thank you!
  • 🥰 If you want to help us, check our Patreon. Thank you!
7.2.0 12 Jul 2026 2 new2 fixed
New
  • Resumable, checkpointed scan runs with staged results that publish only after complete analysis.
  • Private quarantine storage, file identity validation, and idempotent cleanup operations.
Fixed
  • Graceful handling of timeouts, transient server failures, stalled cursors, and parser compatibility queries.
  • Durable keyset pagination for large compatibility-parser datasets.
7.1.1 30 May 2026 1 new3 improved1 fixed
New
  • Confirmation prompt before deleting the Cleaner database.
Improved
  • Full Cornerstone Parser coverage with URL references and improved data parsing.
  • Refactored URL detection to work with relative URLs.
  • Made it clearer when viewing settings versus the dashboard.
Fixed
  • Sped up file deletion by replacing directory scanning with a lazy emptiness check.
7.1.0 17 May 2026 1 new2 fixed
New
  • In-results banner and tooltip clarifying that files marked as "not found in content" may still be used dynamically by builders, templates, or external sites.
Fixed
  • Memory overflow on large sites (1M+ media) by replacing in-memory array counting with SQL count queries.
  • Added check for existing table before deleting attachment-related data.
7.0.9 9 May 2026 3 new1 improved1 fixed3 changed
New
  • Support for Meow Gallery's collections with WPLR integration.
  • Support for WP Download Manager plugin.
  • Filter "wpmc_affect_html_from_builder" for page builders that store their own content, allowing other parsers to still work alongside them.
Improved
  • Search now works across all reference fields.
Fixed
  • Meow Gallery parser now correctly applies WPLR filters on galleries and parses JSON HTML format.
Changed
  • 🎵 Discuss with others about Media Cleaner on the Discord.
  • 🌴 Keep us motivated with a little review here. Thank you!
  • 🥰 If you want to help us, check our Patreon. Thank you!
7.0.8 25 Apr 2026 3 improved1 fixed
Improved
  • Renamed internal origin references for clarity.
  • Path descriptions now use 'thumbnails' instead of 'files' for clarity.
  • Improved UI/UX for better user experience. We hope you'll love it! 🥰
Fixed
  • Image URLs in the metabox are now only added when actually present.
7.0.7 15 Apr 2026 2 new1 improved2 fixed
New
  • New "References Buffer" option to split and flush reference processing to reduce memory errors on large datasets.
  • More detailed timeout debugging for reference extraction to make diagnosing performance issues easier.
Improved
  • Replaced cached references with a unique hash-based system and limited media ID lookups to multilingual URLs for faster and cleaner reference handling.
Fixed
  • Improved base64 handling to better cope with malformed edge cases and prevent related issues.
  • Removed base64 content from HTML before URL parsing to prevent regex timeouts on complex pages.
7.0.6 27 Mar 2026 1 fixed
Fixed
  • Hotfix to resolve a security issue that could allow SSRF attacks through embedded iframes.
7.0.5 9 Mar 2026 3 new1 improved1 fixed
New
  • Introduce LayerSlider compatibility and update Enfold theme integration.
  • Include more direct documentation links in error popups.
  • Provide ACF-specific filters for URLs and IDs to give developers more precise control over field handling.
Improved
  • Improve origin handling so the plugin can work with sources that don't use numeric IDs.
Fixed
  • Ensure plugin checks run after all required options are initialized.
7.0.4 25 Feb 2026 1 new2 improved2 fixed3 changed
New
  • Allow selecting specific thumbnail sizes (to avoid the unnecessary ones).
Improved
  • Improve compatibility with multisite and network site.
  • Apply better default settings on fresh installs.
Fixed
  • Improve how issue names are displayed.
  • Ensure media scans always use ID-based URL references (improving compatibility with WPML).
Changed
  • 🎵 Discuss with others about Media Cleaner on the Discord.
  • 🌴 Keep us motivated with a little review here. Thank you!
  • 🥰 If you want to help us, check our Patreon. Thank you!
7.0.3 27 Jan 2026 1 new3 improved1 fixed
New
  • Added full support for newer versions of the Oxygen builder.
Improved
  • Extended Divi 5 support by recognizing mp4 and webm keys for background videos and the new "linkUrl" key in Divi blocks.
  • Improved Elementor compatibility by having the parser also check page settings for relevant data.
  • Made excluded directories easier to customize by turning them into a configurable setting that developers can filter.
Fixed
  • Updated the Divi integration so URLs with direct UR patterns are no longer incorrectly marked as safe.
7.0.2 5 Jan 2026 2 new2 improved2 fixed
New
  • Support FooGallery album shortcodes for better gallery integration.
  • Display icons for reference tags including SAFE, CACHE, OG_THUMB, and GEN_THUMB.
Improved
  • Improve FooGallery handling by supporting non-HTML shortcode output and flagging cached media items.
  • Remove the transient cache for post types and include the post ID in reference data.
Fixed
  • Prevent warnings and errors caused by empty HTML output and broken shortcodes.
  • Correct the JetEngine parser to ensure dynamic content is detected and rendered properly.

2025 13 versions

7.0.1 16 Dec 2025 3 new2 fixed
New
  • Introduced scan resume support for both Thumbnails and Duplicates scans.
  • Added a new “Optimize Thumbnails” feature.
  • Added support for Toolset.
Fixed
  • Prevented an error in the Metabox parser caused by treating text values like lists.
  • Ensured the “Repair x Entries” notice only appears while repair mode is active.
7.0.0 3 Dec 2025 4 new1 fixed3 changed
New
  • CSV export option for scan results to make it easier to review.
  • Support for pagination in FooGalleries so all gallery items are properly scanned.
  • Recursive scanning for ACF Blocks to ensure nested blocks are fully detected.
  • FooGallery parser support for block shortcodes.
Fixed
  • Prevent the plugin from loading on pages where it is not needed.
Changed
  • 🎵 Discuss with others about Media Cleaner on the Discord.
  • 🌴 Keep us motivated with a little review here. Thank you!
  • 🥰 If you want to help us, check our Patreon. Thank you!
6.9.8 13 Nov 2025 2 new4 improved4 fixed
New
  • Parsed "href" and "src" attributes in Enfold HTML to accurately extract URLs.
  • Support for the "value" attribute in Divi 5 blocks to facilitate ID extraction.
Improved
  • Enhanced UI and UX.
  • Enhanced caching to store IDs and URLs in the DB.
  • Refined Divi parser to support both Divi 4 and Divi 5 simultaneously.
  • Optimized database checks and CLI commands for faster performance.
Fixed
  • Fixed the Smart Slider 3 parser to load correctly and function as expected.
  • Hotfix for handling null values with substr, avoiding deprecated functions.
  • Fixed the Scan confirmation prompt to show only once.
  • Restricted scope of the "substr" function to prevent deprecation issues.
6.9.7 30 Sep 2025 3 new3 improved1 fixed
New
  • Timeout mechanism to avoid a stalled scan.
  • New Duplicates scan type (beta).
  • "Deleted At" column and filters.
Improved
  • Confirmation before restarting a scan to prevent accidental restarts.
  • Better support for Kadence Theme.
  • Optimized the WooCommerce parser for better performance.
Fixed
  • Remove a few minor bugs.
6.9.5 27 Aug 2025 1 new
New
  • A clear message guiding users on how to disable the pop-up.
6.9.4 16 Aug 2025 2 new2 improved2 fixed
New
  • Support for Meow Gallery.
  • Warning modal; Sorry guys, but it looks like we need to warn you better about the risks.
Improved
  • Header included for Filesystem + Content-Type for better handling.
  • Comments: Clarified handling of WebP images for improved compatibility.
Fixed
  • Added check for WP_Error in ACF after database calls to improve stability.
  • Resuming process now properly continues from step 3.
6.9.3 23 Jul 2025 1 new3 improved1 fixed
New
  • Enhanced the resume functionality.
Improved
  • Show incompatible plugins message only in the free version for clarity.
  • Improved memory management by replacing in-memory references with direct processing and transients.
  • Refreshed common libraries for better performance and stability.
Fixed
  • Hotfix for errorCounts modal display to ensure proper visibility.
6.9.2 1 Jul 2025 1 new2 improved1 fixed
New
  • Added support for Fluent Forms.
Improved
  • Streamlined Divi parser for better image URL extraction and improved filesystem handling.
  • Enhanced thumbnail URL extraction and added new function to retrieve attachment sizes.
Fixed
  • Fixed NekoTable display issues.
6.9.1 29 Jun 2025 4 new1 improved
New
  • Support for Kadence Blocks.
  • Support for Salient Theme Elements.
  • Support for Houzez Theme.
  • Support for WooCommerce variation galleries.
Improved
  • Improved Enfold parser with better handling of nested shortcodes and enhanced ID/URL extraction.
6.9.0 11 May 2025 1 improved
Improved
  • Removed unused code for live content checks in CLI commands to improve plugin performance and maintainability.
6.8.9 4 May 2025 1 new1 fixed
New
  • Support for ACF 'file' fields now includes returning the file URL when using ID references.
Fixed
  • Ensure the "Disable Shortcode Analysis" setting is now respected in all content parsers.
6.8.8 1 May 2025 4 new5 improved4 fixed
New
  • Introduced SAFE support for URLs from srcset in WooCommerce galleries.
  • Added a function to extract thumbnail URLs from srcset for better detection.
  • Added a parser for W3 Total Cache to handle media attachments.
  • Introduced a force trash option for cases when trash isn’t emptied automatically.
Improved
  • Enhanced the W3 parser with array_to_ids_or_urls and added recursive support.
  • Temporarily disabled live content scanning to prevent issues.
  • Improved shortcode scanning by retrieving all common attributes for IDs and URLs.
  • Reworked the ACF Parser to fully support flexible content structures.
  • Added an index on mediaId in the references table to optimize step 4 performance.
Fixed
  • Prevented warning messages when URLs are empty.
  • Corrected countdown end event behavior.
  • Corrected a typo in iframe handling comments.
  • Prevented recursion in ACF field scanning with flexible content.
6.8.7 12 Mar 2025 1 improved1 fixed
Improved
  • Improved type handling and updated the Divi parser for better compatibility.
Fixed
  • Added a recursion limit to ACF field scanning functions to prevent infinite loops.