All articles

Why iCloud Drive Makes Duplicate Files Ending in 2 on a Mac

· 5 min read

You copy a folder into iCloud Drive, come back a little later, and next to "Invoice.pdf" there is now "Invoice 2.pdf". Sometimes the "2" is identical to the original, sometimes it's empty, sometimes it's an older version.

Those files are iCloud keeping both of two versions of the same file because it couldn't tell which one should win. It doesn't delete either, which is the safe choice, but it leaves you to sort them out. Here is why it happens, how to clean up without losing anything, and how to copy files into a cloud folder so that it doesn't happen.

Why iCloud creates files ending in "2"

iCloud Drive syncs as you go: as soon as a file appears in an iCloud folder, macOS starts uploading it. Most "2" files come from one of these situations:

  • The same file changed in two places before they synced. You edit a document on your MacBook while it's offline, someone (or you, on another Mac) edits it too, and both versions reach iCloud.
  • A file changed while iCloud was uploading it. iCloud sends a version, the file changes again before iCloud has caught up, and the two versions disagree.
  • A file was uploaded before it was complete. This is the one people rarely suspect, and the one we ran into ourselves.

Not every "2" comes from iCloud, though. When you copy a file into a folder that already has one with the same name and choose Keep Both, the Finder names the new one the same way, and so does Folia Files.

The case we hit: a folder copied from a slow server

In November 2026, a folder copied from an FTP server into a shared iCloud Drive folder left ten empty "… 2" files next to the right ones.

The copy, made with an earlier version of Folia Files, created each file at its final place and filled it as the data came in from the server. iCloud saw a new, empty file and uploaded it. A moment later, the full file was there, with the original date from the server, older than the empty one iCloud had just sent. iCloud ended up with two versions and kept both: the full file, and an empty "2".

Any app that writes a file directly in a synced folder, a little at a time, can trigger this with a slow source (a server, a slow disk, a big download). Folia Files 1.4 no longer does: more on that below.

How to clean up "2" files safely

Don't delete "2" files in bulk before you've looked: sometimes the "2" is the one with your last changes.

  1. Open the folder in a list view: Detailed List (⌘3) in Folia Files, or List view in the Finder. Sort by name so that "Invoice.pdf" and "Invoice 2.pdf" sit together.
  2. Compare their Size and Date Modified. A "2" with a size of zero is an empty copy. One with the same size and date is very likely a duplicate.
  3. When in doubt, select each file and press Space to look at it with Quick Look, or open both.
  4. Move the one you don't want to the Trash (⌘⌫). Don't empty the Trash until you're sure.
  5. If you only keep the "2", rename it to remove the number.

For a big folder, Tools › Duplicate Files in Folia Files finds files with exactly the same content, wherever their names differ, and lets you choose which copy to keep. It only matches identical files: an empty "2" or an older version needs the look in steps 2 and 3.

How to avoid "2" files

Some habits help whatever app you use:

  • Let uploads finish before you open the same file on another device. Folia Files and the Finder both show iCloud's status next to each file; this guide to files still uploading explains what each state means.
  • Avoid editing the same file on two Macs while one is offline.
  • Copy finished files into the cloud folder, rather than downloading or exporting straight into it from a slow source.

What Folia Files 1.4 does when it copies into a cloud folder

Since version 1.4, when Folia Files copies a file into a folder that a cloud syncs, it no longer writes it in place:

  1. It writes the file in a hidden temporary folder on the same disk, outside what the cloud watches.
  2. It sets the file's dates and permissions there.
  3. Once the file is complete, it moves it into place in a single step, and never over an item that appeared in the meantime.

iCloud only ever sees whole files. If you cancel the copy, or it fails, nothing is left at the destination, not even half a file.

This applies to iCloud Drive and its app folders, to the cloud folders of ~/Library/CloudStorage (Dropbox, Google Drive, OneDrive, Box and the other clouds that use macOS's File Provider), and to your Desktop and Documents when they are stored in iCloud. Copies within the same disk were already safe: on APFS they are clones, which arrive complete at once.

Grey, not red: errors iCloud will retry

The same evening, the twelve biggest files of that folder showed an error while uploading: "Couldn't access your iCloud account. The iCloud servers might be unreachable…". A few minutes later, they had all gone up without anyone doing anything.

Folia Files 1.4 tells those cases apart. When iCloud reports an error it retries by itself (servers unreachable, the network, too many requests) and the file is still uploading, its badge stays grey, Waiting to Upload, and its tooltip shows iCloud's message with "It will try again by itself." The red badge is kept for errors that need you.

To see these badges, keep Show the state of cloud files after their names turned on in Settings › Files and Network (it is on out of the box).

Finder or Folia Files?

The Finder shows iCloud's status icons too, and its Keep Both behaves the same way. The difference is in the details above: how a copy reaches a synced folder, and whether a temporary error looks like a real one. Folia's way of copying, with undo for every operation, is described on the safe file operations page.