◆Error Codes Wiki

iCloud Drive Sync Stuck Downloading — Files Not Syncing or Showing Cloud Icon

Erroricloud

Overview

Fix iCloud Drive files stuck in downloading state, showing a permanent cloud download icon, or not syncing between Mac and other Apple devices.

Key Details

  • iCloud Drive syncs files across all Apple devices and icloud.com via cloud storage
  • Files with a cloud icon with download arrow need to be downloaded from iCloud before they can be opened
  • Optimize Mac Storage feature automatically offloads files to iCloud when disk space is low
  • The bird process (bird/cloudd) handles iCloud Drive sync operations in the background
  • Large files or many files queued for download can cause the sync to appear stuck

Common Causes

  • Slow or unstable internet connection causing download timeouts
  • iCloud servers experiencing temporary issues or maintenance
  • The bird/cloudd sync daemon hung or crashed
  • Insufficient local disk space to download files from iCloud

Steps

  1. 1Check iCloud status at apple.com/support/systemstatus for any iCloud Drive issues
  2. 2Restart iCloud sync daemon: Terminal > 'killall bird' (the process will restart automatically)
  3. 3Force download specific files: right-click file in Finder > Download Now
  4. 4Check available disk space: Apple menu > About This Mac > Storage
  5. 5Sign out of iCloud and sign back in: System Settings > Apple ID > Sign Out, then sign back in

Tags

icloud-drivesyncdownloadstuckcloud-storage

More in Icloud

mac-icloud-sync-stuckMac iCloud Sync Not Working
Warning
mac-icloud-keychain-not-syncingiCloud Keychain Not Syncing — Passwords Missing Across Apple Devices
Warning
mac-icloud-photos-sync-pausediCloud Photos Sync Paused — Photo Library Not Uploading or Downloading
Warning

Frequently Asked Questions

bird (also called cloudd in newer macOS) is the iCloud sync daemon. It handles all iCloud Drive file synchronization in the background. Killing it forces a restart and can resolve stuck sync states.