iCloud Drive Sync Stuck Downloading — Files Not Syncing or Showing Cloud Icon
About iCloud Drive Sync Stuck Downloading
Fix iCloud Drive files stuck in downloading state, showing a permanent cloud download icon, or not syncing between Mac and other Apple devices. This guide covers everything you need to know about this topic, including common causes, step-by-step solutions, and answers to frequently asked questions.
Here are the key things to understand: 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. Understanding these fundamentals will help you diagnose and resolve this issue more effectively.
The most common reasons this occurs include: 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. Identifying the root cause is the first step toward finding the right solution.
To resolve this, follow these recommended steps: Check iCloud status at apple.com/support/systemstatus for any iCloud Drive issues. Restart iCloud sync daemon: Terminal > 'killall bird' (the process will restart automatically). Force download specific files: right-click file in Finder > Download Now. Check available disk space: Apple menu > About This Mac > Storage. Sign out of iCloud and sign back in: System Settings > Apple ID > Sign Out, then sign back in. If these steps do not resolve the issue, consider consulting additional resources or a qualified professional.
This article is part of our Mac Error Codes collection on Error Codes Wiki. We provide comprehensive, up-to-date information to help you find solutions quickly.
Quick Answer
What is the bird process?
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.
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
- 1Check iCloud status at apple.com/support/systemstatus for any iCloud Drive issues
- 2Restart iCloud sync daemon: Terminal > 'killall bird' (the process will restart automatically)
- 3Force download specific files: right-click file in Finder > Download Now
- 4Check available disk space: Apple menu > About This Mac > Storage
- 5Sign out of iCloud and sign back in: System Settings > Apple ID > Sign Out, then sign back in