How to Fix ‘iCloud Drive Is Synchronizing’ Stuck on Mac

Working on documents stored in iCloud Drive on macOS Sequoia or Sonoma only to notice a persistent spinning progress pie or an endless status message stating ‘Synchronizing…’, ‘Uploading 1 item’, or ‘Downloading items’ prevents access to updated files across your Apple ecosystem. When iCloud Drive synchronisation hangs on Mac, files created on iPhone or iPad fail to appear in Finder, desktop and documents folders display dotted cloud icons, and battery drain increases as background cloud daemons consume processor cycles. This stall occurs when the macOS cloud synchronization daemon (bird) deadlocks on a locked file handle, when CloudKit database metadata corrupts, or when zero-byte temporary files block the upload pipeline.

Why Does iCloud Drive Get Stuck Synchronizing on Mac?

macOS synchronizes iCloud Drive using a dedicated subsystem comprising the bird and cloudd background daemons. Synchronization freezes due to:

  • Stalled ‘bird’ Background Process: The primary macOS iCloud Drive daemon entering an unresponsive thread state after sleep or network transitions.
  • Corrupted CloudKit Metadata Index: Stale SQLite tracking tables inside ~/Library/Application Support/CloudDocs misreporting file sync states.
  • Locked System Temporary Files: Office, Photoshop, or text editors leaving hidden lock files (e.g. .DS_Store or ~$Document) open in synced directories.
  • Low Local Storage Space: macOS requiring at least 10% free SSD capacity to assemble local staging chunks prior to cloud upload.

Step 1: Force Restart the macOS ‘bird’ Daemon

Terminating the bird daemon releases stuck network handles. macOS automatically restarts the process immediately with clean threads.

  1. Open Terminal from Spotlight or Launchpad.
  2. Execute the following command to terminate the iCloud Drive daemon:
    killall bird
  3. If the CloudKit daemon is also unresponsive, terminate both services simultaneously:
    killall cloudd bird
  4. Observe Finder: within 10 to 20 seconds, the bird daemon will respawn, recalculate file differences, and resume file transmission.

Step 2: Identify the Stalled File Using brctl in Terminal

macOS includes the internal CloudDocs command-line utility (brctl) to monitor live iCloud transfers.

  1. In Terminal, execute the following command to inspect active cloud sync queues:
    brctl status
  2. Review the output for items listed under ‘sync engine’ or ‘uploading’.
  3. To stream live real-time sync diagnostic logs, run:
    brctl log --wait --short
  4. Locate the specific file path throwing recurring upload errors or timeouts. Move that file out of iCloud Drive to your local Downloads folder temporarily to allow pending queues to flush.

Step 3: Toggle iCloud Drive Off and On in System Settings

Re-engaging the iCloud Drive client resets the local handshake with Apple servers.

  1. Click the Apple menu > System Settings.
  2. Click your Apple ID profile at the top of the left sidebar.
  3. Select iCloud > iCloud Drive.
  4. Toggle off Sync this Mac.
  5. When prompted whether to keep a local copy of your iCloud Drive files on your Mac, choose Keep a Copy.
  6. Restart your Mac.
  7. Return to System Settings > Apple ID > iCloud > iCloud Drive, and toggle Sync this Mac back on.

Step 4: Purge Corrupted CloudDocs Metadata Cache

If iCloud Drive remains permanently stuck, deleting corrupted local database caches forces macOS to rebuild clean manifests.

  1. In Finder, click Go > Go to Folder… (or press Cmd + Shift + G).
  2. Paste the following directory path and press Enter:
    ~/Library/Application Support/CloudDocs
  3. Select the files inside (such as session.db and metadata folders) and move them to the Trash.
  4. Restart your Mac to allow macOS to download a pristine index from iCloud.

Step 5: Verify Optimise Mac Storage Settings

Aggressive storage purging can trigger continuous re-download loops for active documents.

  1. Navigate to System Settings > Apple ID > iCloud.
  2. Review the Optimise Mac Storage toggle.
  3. If you have ample SSD capacity, turn this feature Off to force macOS to store complete offline copies of files locally, avoiding downloading latency.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.