In the free version, this “smart” replacement functionality is only available for WordPress’s built-in featured image (aka thumbnail) fields — so when you delete a duplicate file that’s embedded or linked somewhere else, such as in the body of a post, it may be “broken” on your site.

The Pro version has been extended to also intelligently replace images in many other locations, including references in the post body, gallery shortcodes, and extra fields from WooCommerce, JetPack, and Yoast SEO. Using Pro makes it much less likely that a deleted duplicate will have a negative effect on your site!

The Pro version also includes dedicated support from the Cornershop team.

There are two important questions to consider when determining whether Media Deduper Pro will work on your site.

1. Are images hosted locally?

About 99% of the time, the answer to this question is yes. But some plugins or custom setups allow you to add externally hosted images — images hosted by another website — to your WordPress media library. 

Media Deduper Pro is not compatible with such a setup.

The files in your WordPress media library must exist on the same server as WordPress’s PHP files for Media Deduper to be able to analyze them and find duplicates.

If you use a third-party CDN to serve images to your visitors, don’t worry; That’s still fine as long as the original images remain on your web server.

2. Is your WordPress site accessible to the public? More specifically, is the site accessible to itself?

For the Media Deduper Pro indexer to run properly, your site needs to be able to establish an HTTP connection to itself, which is sometimes referred to as a “loopback” connection.

Plugins or hosting setups that require visitors to enter a password or accept/have a cookie in order to access your site may prevent Media Deduper Pro from analyzing and indexing your attachments.

For example, if your site is protected by HTTP basic authentication using an .htpasswd file, the MDD indexer will not be able to run without a bit of custom code (which we can provide).

Some “maintenance mode” plugins have also been known to interfere with the indexing process.

Still have questions about whether Media Deduper Pro will work for you? 
Please contact us.

Media Deduper scans each media library file and creates a unique code or “hash” based on the contents of the file itself. This means it finds duplicates based on the actual data in the file, not on the filename or any other associated information. It’s the only way to be sure!

Please note that the image data must be identical, not just similar.

For instance, Media Deduper will NOT consider two images to be duplicates if their brightness, resolution, or format (e.g. JPEG or PNG) differ, even if they are copies of the same original image.

When the plugin is first installed, it can take some time to completely scan existing media files to build the Media Deduper index, especially if you have many years’ worth of files in your library or many very large files (such as videos). This is because each distinct file receives its own index key.

Media Deduper Pro will intelligently replace images used in the stock WordPress “gallery” shortcode as well as in fields created by WooCommerce, JetPack, and Yoast SEO.

More plugin integrations are planned, but if you have any favorites that you’d like to make sure we’re working on, please let us know!

If you plan to use the feature to remove existing duplicates, then we would strongly recommend you purchase the Pro version, so you don’t end up with broken images on your site.

Media Deduper only deletes unused media library files, and it does not delete unused image file sizes that are automatically created by WordPress.

Yes, but you’ll need to write some code of your own code to tell Media Deduper Pro which custom fields to look in and how images are stored there. 

Depending on your implementation, a custom field might reference an image by its post ID, or by its URL, or a field might contain image tags or shortcodes. 

Check out our documentation for the mdd_get_reference_fields filter to learn how to tell Media Deduper Pro which fields it should pay attention to and what type of data it should expect to find there.

By default, Media Deduper Pro will replace any images in any post type that was registered with the “public” parameter set to TRUE (see https://developer.wordpress.org/reference/functions/register_post_type/#parameters)


If you have non-“public” post types that also might contain images that should be replaced, you’ll need to explicitly tell Media Deduper Pro about them. Check out our documentation to learn more about the mdd_get_reference_post_types filter and instructions.

We are constantly updating Media Deduper Pro to be compatible with the most popular plugins on WordPress.  Currently, Media Deduper Pro is incompatible with:

Easy Fancybox
Js_composer
LayerSlider
NextGEN Gallery
OptimizePress
Page Builder by Site Origin
Responsive Lightbox
Revslider
SiteOrigin Widgets Bundle
Ultimate_VC_Addons
WP Retina 2x

This is not an exhaustive list of plugins that are not currently compatible with Media Deduper Pro. If you have a specific plugin that you have a question about, please contact us.

For a complete changelog for Media Deduper Pro, check out the version history page!

If the plugin does not work on your site, please contact support@cornershopcreative.com to request a refund.  Please note we can only honor refunds up to 30 days from purchase.

Cornershop can also provide customized support on your website at our standard maintenance rate of $200/hour.