False Positive Issues

Sometimes when the scan finishes and shows you a list of files marked as “unused,” some of those files may actually be used by your site. Deleting them can result in media disappearing from your pages. When this happens, it’s simply because Media Cleaner doesn’t recognize how that specific media is being used.

Step 1: Understand how the media is used

Go to the post where the image is missing and check how the image is used. Is it referenced directly in the content? Is it being loaded by a third-party plugin (like a gallery), a widget, a theme feature, or a page builder?

Step 2: Check if the plugin/theme is supported

Go to the Parsers tab in the Media Cleaner settings and check if the plugin, builder, or theme you’re using is listed.

If it’s not listed: Media Cleaner doesn’t currently support it.
If it is listed but the image is still flagged as unused: the parser may be outdated or not working properly.

If Media Cleaner has no Parser for your use case

➤ For well-known plugins (600+ reviews on WordPress.org)

Let us know via support, and we’ll evaluate the possibility of adding a parser. Once tested, it will be made available to all users.

➤ For lesser-known or custom plugins (less than 600 reviews on WordPress.org)

If you’re using a niche or custom plugin, it’s best to contact that plugin’s developer and ask them to add support for Media Cleaner.

If you have technical knowledge, you can also create your own parser. Here’s a template to get started.

➤ For PRO / Paid plugins (require a license and are not available on WordPress.org)

Let us know through support which plugin you’re using.

If possible, please share a copy of the plugin along with any activation details needed so we can recreate the false positive issue and build the appropriate parser to handle it.

Ideally, if your site isn’t too large, a WordPress export (or a staging version containing just a few sample posts) would allow us to reproduce the exact same environment and ensure the parser works correctly for your specific use case.

If you’re unable or prefer not to share the plugin or your site, just let us know. We can contact the plugin’s developers directly to request a temporary copy for testing. Please note that this approach may take a bit longer.

If the Pro/Paid plugin is also fairly niche (fewer than 600 reviews), it’s usually best to contact the plugin’s developer directly and ask them to add support for Media Cleaner on their side using our parser template. This is often the fastest and most reliable approach, as they know their own data structure best.

If Media Cleaner has a Parser but not working

Which plugin/builder/theme you’re using
Clear steps to reproduce the issue using a new post
Screenshots if needed, this helps us reproduce the issue and fix the parser accurately.