Hello folks! You drag a folder into iCloud Drive, and the little cloud icon just sits there. “Waiting to Upload.” An hour later, still waiting. You restart your Mac, hoping that fixes it. Nope, still waiting. If this sounds familiar, you’re not losing your mind. This is one of the most annoying, long-running bugs in iCloud, and it’s been around since macOS Big Sur.
killall bird to force iCloud’s sync process to restart, which clears most stuck uploads within a few minutes. If that doesn’t work, check for files with names iCloud won’t accept (like “tmp,” “Dropbox,” or names with a colon), sign out of your Apple ID and back in, or move the stuck file out of iCloud Drive and back in to force a fresh upload attempt.
Why iCloud Drive gets stuck on “Waiting to Upload”
Before you start clicking buttons, it helps to know what’s actually happening. iCloud syncing on your Mac is handled by a background process called bird. Yes, that’s really its name. When bird hangs, gets confused by a bad file, or loses its connection to Apple’s servers, your uploads just… stop. No error message, no explanation. The cloud icon with the little upload arrow just spins forever.
A few things commonly trigger this:
- A weak or dropping Wi-Fi connection mid-upload
- A file or folder name iCloud secretly refuses to sync
- Your iCloud storage being full (checked this one myself more than once)
- The bird process itself getting stuck in a bad state
- A temporary outage on Apple’s end
The good news: none of these need a full reinstall of macOS. Work through the steps below in order, and most people get unstuck by step three.
Step 1: Check your internet connection first
This sounds too obvious to mention, but it’s the number one cause. iCloud Drive needs a steady connection to upload, and it doesn’t handle drop-outs gracefully. Open a browser and load a random website. If pages are slow or timing out, that’s your problem, not iCloud.
If you’re on Wi-Fi, try switching to a different network, or plug in with Ethernet if you have the option. Sometimes a router restart is all it takes.
Step 2: Check your iCloud storage isn’t full
Apple gives you 5GB free, and it fills up fast once you add Photos and device backups into the mix. Go to System Settings > your name at the top of the sidebar > iCloud, and look at the storage bar. If it’s nearly full, uploads will just quietly refuse to complete instead of giving you a clear warning.
If you’re out of space, either free up room (delete old backups you don’t need) or bump up your storage plan for a few dollars a month. It’s annoying, but it’s a five-minute fix.
Step 3: Restart the bird process
This is the fix that works most often, and it takes about ten seconds. Open Terminal (you’ll find it in Applications > Utilities, or just search for it with Spotlight), type this command, and press Return:
killall bird
You might be asked for your admin password. Once you enter it, the bird process quits and macOS automatically restarts it fresh. Give it a minute or two, then check if your files start uploading. This fixed a stuck 40GB photo folder for me in under five minutes, and I didn’t have to touch a single setting.
Prefer clicking over typing? Open Activity Monitor, search “bird” in the top-right search box, select it, and click the X button in the toolbar. Choose Quit (not Force Quit, unless Quit doesn’t respond). It’ll relaunch on its own.
Step 4: Look for a file name iCloud won’t accept
Here’s the part almost nobody checks, and it’s often the real culprit when one specific file or folder refuses to move while everything else uploads fine. iCloud Drive silently rejects certain file and folder names, including:
- Names that are exactly “tmp,” “Dropbox,” or “OneDrive”
- Any name containing a colon (:)
- Names starting with a period
If you’ve got a stuck file, rename it to something plain, like “test-file,” and see if it starts uploading right away. If it does, you’ve found your problem. Rename it back to something close to the original, just without the offending character, and move on.
Emoji and other special characters usually work fine on your Mac alone, but they can cause weird sync hiccups when iCloud has to reconcile them across devices. If you love using emoji in file names (no judgment), just know that’s a common source of ghost sync errors.
Step 5: Sign out of your Apple ID and back in
This one feels drastic, but it doesn’t delete anything. It just forces a clean reconnection to iCloud’s servers. Go to System Settings, click your name at the top of the sidebar, scroll down, and click Sign Out. When it asks, choose Keep a copy so your local files stay put.
Once you’re signed out, restart your Mac, then sign back in with the same Apple ID. iCloud will re-index everything, which can take a while for a big library, but it usually clears out whatever glitch was blocking the upload.
Step 6: Move the file out and back in
If one particular file is the holdout, drag it out of the iCloud Drive folder onto your Desktop, wait a few seconds, then drag it back in. This forces macOS to treat it as a brand-new upload instead of retrying a broken one. Clunky, but it works surprisingly often for single stubborn files.
Tips and troubleshooting
- Check Apple’s system status page before you spend an hour troubleshooting. If iCloud Drive is down on Apple’s end, no amount of restarting bird will help.
- Update macOS. Apple has quietly patched iCloud sync bugs in past point updates, so if you’re a few versions behind, that alone might solve it.
- Big files take time, and that’s normal. A single 4K video or a huge Photos library can look “stuck” when it’s actually just slow. Give large uploads a realistic amount of time before assuming something’s broken.
- Don’t force quit bird repeatedly. If killing it once doesn’t help, killing it five more times in a row won’t either. Move on to the next step instead.
Frequently asked questions
Why is my iCloud Drive stuck on “Waiting to Upload”?
Usually it’s a weak internet connection, a full iCloud storage plan, or the background sync process (bird) getting stuck. Less often, it’s a specific file with a name iCloud won’t sync, like one containing a colon.
Is it safe to kill the bird process on my Mac?
Yes. Running killall bird just restarts iCloud’s sync helper. It doesn’t touch your files or settings. macOS relaunches the process automatically within a few seconds.
How do I force iCloud Drive to sync on Mac?
Restart the bird process with Terminal or Activity Monitor, check your storage isn’t full, and make sure your Wi-Fi connection is stable. If a single file won’t move, try renaming it or dragging it out and back into the iCloud Drive folder.
Why won’t some files upload to iCloud Drive at all?
iCloud Drive rejects a small list of reserved names (like “tmp” or “Dropbox”) and any name with a colon in it. If a file has one of these names, rename it and the upload should start immediately.
Got a stuck file that none of these steps fixed? Tell me what’s in the name and how big it is in the comments, and I’ll dig through what’s worked for other readers and point you toward the next thing to try.
Image credits: featured photo by Oops4321 (CC BY-SA 4.0), settings photo by Intel Free Press (CC BY 2.0), workspace photo by David Wellbeloved (CC BY 2.0), via Wikimedia Commons.