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.
