Sanity deduplicates identical image uploads by hash?

10 replies
Last updated: Jan 27, 2026
Is it correct that if I upload the exact same image, I won't get duplicate assets? For every upload I do of the same image, it returns a result with the exact same
_id
and
url
, and
count(*[_type == "sanity.imageAsset"])
doesn't change.This is the behavior I want, but I would assume it uploaded a new asset for each attempt, and didn't do a compare or something. So just want to confirm this behavior before I rely upon it.
🙂
AI Update

Yes, this is correct and confirmed behavior that you can rely on! Sanity implements automatic asset deduplication based on the content of the file itself.

When you upload an image to Sanity, the platform generates a deterministic ID based on the actual image content (using a SHA-1 hash). This means that uploading the exact same image multiple times will:

  • Return the same _id every time (formatted as image-<sha1hash>-<dimensions>-<format>)
  • Point to the same url
  • Not create duplicate sanity.imageAsset documents in your Content Lake
  • Keep your count(*[_type == "sanity.imageAsset"]) unchanged

As mentioned in the Sanity documentation on uploading assets efficiently, "Images uploaded to the Content Lake receive deterministic IDs based on the image content itself, ensuring that uploading the same image multiple times results in the same ID without creating duplicate documents."

This is a deliberate feature that helps prevent asset bloat and keeps your Content Lake clean. It's particularly useful when:

  • Running migration scripts that might process the same images multiple times
  • Multiple content editors upload the same brand assets or stock photos
  • Automated systems upload images programmatically

So you can absolutely rely on this behavior in your workflows! The deduplication happens automatically at the platform level based on the file's content hash, not just the filename, so even if you upload the same image with different filenames, it will be deduplicated.

Show original thread
10 replies

Sanity – Build the way you think, not the way your CMS thinks

Sanity is the developer-first content operating system that gives you complete control. Schema-as-code, GROQ queries, and real-time APIs mean no more workarounds or waiting for deployments. Free to start, scale as you grow.

Was this answer helpful?