# Prevent Duplicate Image Uploads

> Stop duplicate images before they pile up. ThumbPress checks each upload by file hash and blocks re-uploads of images already in your media library.

- Canonical URL: <https://thumbpress.co/features/prevent-duplicate-uploads>
- Markdown URL: <https://thumbpress.co/features/prevent-duplicate-uploads.md>

Category: Storage feature

Stop the same image landing in your library twice under a different name. ThumbPress checks every upload against what you already have and blocks the copy before it's saved.

## The Same Image, Uploaded Again and Again

Duplicates don't announce themselves - they quietly build up until your library is a mess.

### Renamed, Not Removed

A team member downloads an image, renames it, and re-uploads it. WordPress sees a "new" file and keeps both - byte-for-byte identical.

Impact: 2 copies of every file you never needed

### Wasted Disk and Backups

Every duplicate takes real storage, and your backups copy it too - so you pay to store the same pixels twice, month after month.

Impact: Storage and backup cost, doubled

### Cleanup After the Fact

Most tools let duplicates accumulate for months, then make you hunt them down and delete safely without breaking a page.

Impact: Hours of cleanup you can avoid

## How Prevent Duplicate Uploads Works

It works at the source - the moment a file is uploaded, before it's ever saved.

### Steps

1. **Hash** — As each image is uploaded, ThumbPress generates a content hash (md5) from the file itself - not its name.
2. **Compare** — It checks that hash against the images already in your media library to spot a byte-identical match.
3. **Block** — If the file already exists, the upload is stopped so the duplicate never enters your library.

### What It Checks at Upload

A single toggle - once it's on, every upload is checked the same way.

#### Content, not filename

Matching is done on the file's actual bytes via a content hash, so a renamed copy of an existing image is still caught. Two files with the same name but different content are treated as different images and allowed through.

#### One toggle, always on

Enable it once and every future upload is checked automatically - no per-file steps, no scanning runs, nothing to remember.

## Clean at the source

Prevention beats cleanup - keep duplicates out instead of chasing them later.

- Matches by file content, not filename
- Renamed copies of existing images still caught
- Same-name, different-content files allowed through
- Runs at upload time, before anything is saved
- One toggle - no scans or manual steps
- Checked locally - nothing leaves your site

## Frequently Asked Questions

### How do I stop WordPress allowing duplicate uploads?

Turn on Prevent Duplicate Uploads in ThumbPress Pro. From then on, every upload is checked against your existing media and blocked if a byte-identical file already exists.

### Does WordPress detect duplicate uploads on its own?

No. WordPress happily saves the same image again under a slightly different filename. ThumbPress adds the hash check that WordPress lacks.

### How does hash-based detection work?

ThumbPress generates a content hash (md5) from the file's actual bytes. If that hash matches an image already in your library, the file is a true duplicate and the upload is stopped.

### Will it block a file that has the same name but different content?

No. Matching is done on content, not the name - so two genuinely different images are always allowed, even if they share a filename.

### What does the person uploading see when a duplicate is blocked?

The upload is stopped with a message explaining the file is already in the library, so they can go and use the existing image instead of wondering why nothing happened.

### Does the check slow uploads down?

Not noticeably. It hashes the incoming file once and compares that against stored hashes - a fraction of the time the upload itself takes.

### What about the duplicates already in my library?

Prevention only guards new uploads. To clean up copies that are already there, use Detect Duplicate Images, which groups the existing ones and merges them safely.

### If I delete an image, can I upload it again?

Yes. Once a file is out of the library there is nothing left to match against, so re-uploading works normally.

## Ready to Keep Duplicates Out?

Get started today. Love it or get a refund within 30 days.

## About ThumbPress

ThumbPress is a WordPress plugin for image optimization and thumbnail management, built by Codexpert. It runs on your own server: compression, WebP/AVIF conversion and cleanup all happen locally, with no third-party image API and no per-image credits.

- All features: <https://thumbpress.co/features>
- Pricing: <https://thumbpress.co/pricing>
- Documentation: <https://thumbpress.co/docs/>
- Blog: <https://thumbpress.co/blog/>
- Support: <https://help.pluggable.io/new-ticket/>
- WordPress.org listing: <https://wordpress.org/plugins/image-sizes/>