Why does iCloud Drive get stuck on a single file?
Short answer: iCloud Drive stalls on a single file when the background sync daemon ("bird") encounters a file it cannot process: a filename with characters that iCloud servers reject (colons, forward slashes, or some Unicode symbols), a file that is open and locked by another application, or a Mac with less than 1 GB of free disk space (iCloud cannot create the temporary staging file needed to upload). The "bird" daemon also occasionally enters a retry loop where it keeps attempting a failed upload without any progress. Restarting the daemon, checking disk space, and renaming the problem file cover the majority of cases.
How to fix iCloud Drive sync stuck on a file
Step 1: Identify and rename the stuck file
Open Finder → iCloud Drive. At the bottom of the Finder window, the status bar shows how many items are uploading. Click on the spinning sync indicator in the macOS menu bar (the iCloud icon) to see which file is stuck. If the filename contains unusual characters — especially a colon (:), slash (/), or a very long name over 255 characters — rename it with standard alphanumeric characters. iCloud servers use file naming rules inherited from Apple's HFS+ filesystem, and filenames that worked on a local drive can fail to upload to iCloud's servers. This single step resolves roughly a third of stuck-sync reports.
Step 2: Force-quit the iCloud sync daemon
The iCloud sync daemon is named "bird" (because it carries files to the cloud — Apple's naming). Open Activity Monitor (Finder → Applications → Utilities → Activity Monitor), search for "bird" in the search field, click on the bird process, and click the force-quit button (the X icon). macOS relaunches bird automatically within seconds. This clears the daemon's internal queue and forces it to re-evaluate all pending uploads and downloads from scratch. Force-quitting bird fixes stuck sync in the majority of cases where the filename and disk space are both fine. After restart, give iCloud 5–10 minutes to rebuild its queue.
Step 3: Check and free local disk space
Go to Apple Menu → About This Mac → Storage. If the Mac has less than 2–3 GB free, iCloud cannot stage upload files properly and will stall. Free up space by emptying the Trash, deleting large downloads, or moving old files to an external drive. The macOS Time Machine backup guide covers how to identify storage hogs and manage iCloud's "Optimise Mac Storage" feature, which can free significant space by offloading iCloud-only files automatically.
Step 4: The India angle — variable upload speeds and iCloud throttling
India-specific broadband plans often have asymmetric speeds with upload bandwidth significantly lower than download — 10–20 Mbps upload is typical even on 100 Mbps broadband plans. A 500 MB file takes roughly 4–7 minutes to upload at these speeds, and iCloud does not show per-file progress, only a total item count. Before diagnosing a stall, wait at least 15 minutes and check that the item count is not slowly decreasing. Also note that iCloud throttles uploads during high-traffic periods on Apple's servers — reconnecting to the same Wi-Fi network after toggling it off and on can sometimes assign a less congested upload path. Most apparent "stuck" iClound Drive syncs in India resolve within 20 minutes without any intervention. Genuinely stuck syncs — where the same file shows as uploading for over an hour — need the daemon restart approach.
When to call a laptop repair service
When DIY ends
Seek professional help if: iCloud Drive consistently fails to upload specific file types (may indicate a macOS system file conflict); if iCloud shows "Account storage full" even after you know you have space (an account consistency issue requiring Apple Support contact); or if you suspect a file on the local Mac's SSD is corrupted and causing the loop. A failing SSD can cause read errors on the file being uploaded, causing iCloud to retry indefinitely.
Typical cost in India
macOS software troubleshooting at a service centre: ₹500–₹1,200. If the SSD needs replacement due to read errors: ₹3,500–₹8,000 for an Apple-compatible NVMe SSD with data migration. iCloud storage plan upgrades (for account-full issues): handled directly through your Apple ID at approximately ₹75–₹219/month depending on plan.
A note from the LRW Engineer Team
iCloud sync issues are almost always software-level problems that don't require bringing your Mac in. The bird restart and filename check together resolve the vast majority of stuck syncs in under five minutes. Where we do see genuine hardware involvement is when an ageing MacBook SSD develops marginal read sectors — iCloud cannot consistently read the file to upload it, so it keeps retrying. If you see the same file stuck for multiple days and the daemon restart doesn't help, that is worth a physical diagnostic.