Find duplicate files in your iCloud Drive on Mac
iCloud Drive duplicates eat into your iCloud plan. Here's a safe way to find them without breaking the sync.
iCloud Drive duplicates cost you twice — once on disk locally and again against your iCloud storage quota. If you’re bumping up against your 200 GB or 2 TB plan, dedupe before you upgrade. Most iCloud Drives are full of duplicated PDFs, photos, and old project folders that got copied during a Mac migration.
Two paths
The native way: Finder + System Settings
iCloud Drive shows up in Finder under iCloud > iCloud Drive. You can browse it like any other folder, but with one catch: files marked “Optimized” might be dataless placeholders that need to download first.
- Open System Settings > Apple ID > iCloud > iCloud Drive and turn off “Optimize Mac Storage” temporarily so all files are local.
- Wait for everything to download.
- Open iCloud Drive in Finder, sort by Size.
- Look for files with identical sizes; verify pairs with Preview or
shasum. - Drag duplicates to the Trash. They’ll be removed from iCloud across all your devices.
This works but downloading “everything” can take hours, and manual comparison is unreliable past a few dozen files.
The Dupe way
Dupe handles iCloud Drive properly — including dataless placeholder files.
- Download Dupe and open it.
- Click “Add Folder” and select iCloud Drive (or a specific subfolder like Documents or Desktop, which sync via iCloud if you have that enabled).
- Click “Scan.” For files that haven’t downloaded yet, Dupe will request them from iCloud as needed.
- Review the duplicate groups by file path.
- Move copies to the Trash. Deletions sync to iCloud and remove from your other devices.
Important things to know about iCloud and dedupe:
- Deleting from iCloud Drive removes the file from every device signed in. That’s how iCloud works — Dupe doesn’t change that. The local Trash on your Mac still holds the file for 30 days, and iCloud’s Recently Deleted folder holds it for 30 days too.
- “Desktop & Documents” syncing through iCloud means your Desktop and Documents folders are iCloud Drive. Files there count against your plan.
- Dupe won’t dedupe across your other devices — only on the Mac you run it on. But because iCloud syncs, removing duplicates on one Mac propagates to all of them.
Safety:
- Trash only on the local Mac. iCloud also keeps deleted files in Recently Deleted for 30 days.
- The iCloud Drive system folders (
~/Library/Mobile Documents/com~apple~CloudDocs/.com.apple.*) are excluded. - Byte-identical matching only.
One scan of a long-lived iCloud Drive often frees enough space to drop down a storage tier.
More Dupe tips
-
Apple Photos Duplicates album — what it catches and what it misses
The Photos app Duplicates album is handy, but it has real limits. Here's what it finds, what it doesn't, and how to fill the gaps.
-
Clean up leftover files from uninstalled apps on Mac
Dragging an app to the Trash doesn't remove all its data. Here's where the leftovers live and how to clean them.
-
Clean up your Mac without buying a cleaner app
Most paid cleaner apps do things macOS already does. Here's a free, manual workflow that's just as effective.
-
A no-bullshit guide to cleaning up your Mac's disk
Skip the SEO bait and the sketchy cleaner apps. Here's what actually works to reclaim disk space on a Mac.