How duplicate files are identified

Media Deduper Pro compares the data in each attachment’s original file, not its title, caption, or other WordPress metadata. It calculates an MD5 hash and stores it as attachment metadata; matching hashes identify files with the same data.

The add-on can distinguish separate media items linked to files with identical data from multiple items pointing to the same underlying file. The latter can happen with plugins such as WP Job Manager or Duplicate Post.

Index the library and review matches

Media Deduper builds an index of the media library before identifying duplicates. The initial indexing can take time, especially in a large library. Media Deduper Pro adds faster indexing, and new uploads are added automatically after the initial index is ready.

Open Media > Manage Duplicates to review the matches. The list includes each matching copy because the plugin cannot determine which one you prefer based on its metadata or your process. It is sorted by file size by default, helping you review larger files first.

What Smart Delete checks

Smart Delete processes selected items one at a time and will not remove the last copy of a file. If a post’s Featured Image is a duplicate, Smart Delete can reassign it to an already-used copy before removing the duplicate, helping preserve the post’s appearance.

Smart Delete tracks Featured Images only. It does not check images used in galleries, post bodies, shortcodes, meta fields, or other locations.

Image fields from other extensions

Media Deduper Pro works with picture fields from several popular plugins, including WooCommerce and Yoast SEO.

Review before removing files

Install the plugin, open Media > Manage Duplicates, and allow the initial index to finish. Review the listed copies before deleting anything, and keep at least one copy of each file. Back up your site data before cleanup because deletion can permanently affect database entries or files.

Media Deduper requires PHP 7.0 or later. Media Deduper Pro includes dedicated support from Cornershop Creative.