You save a file to iCloud Drive and it never finishes. Finder on your Mac says 'Waiting to Upload'. The file you added on your iPhone doesn't appear on your other devices. A folder you dragged in on a Windows PC never reaches your phone.
Apple's definition of 'Waiting to Upload' is short: the folder or file is not yet stored in iCloud. It is a status, not an error message, and that page gives no time limit for it. Apple's help points to a short list of causes: your iCloud storage is full, the item is over the size limit, the connection isn't getting through, a data or battery saving mode is holding things back, or iCloud itself has a problem.
First: read the status, and keep your copy safe
On a Mac, open Finder, click 'iCloud Drive' in the sidebar, choose 'View' > 'as List', then 'View' > 'Show View Options' and select 'iCloud Status'. You will usually see 'Waiting to Upload', 'Out of Space' or 'Ineligible', or a pie chart that fills up as the file transfers. If the pie chart is moving, the upload is working and needs time. Apple publishes no upload status list for iPhone, iPad or Windows, so on those devices sign in at icloud.com/iclouddrive: if the file is listed there, it has reached iCloud.
A file that hasn't uploaded isn't in iCloud, so the copy on this device may be the only one. Copy anything important out of iCloud Drive before you try a fix, and copy rather than drag, because Apple says dragging an item out on a Mac or a Windows PC removes it from iCloud Drive on all your devices. In the Files app, use 'More' > 'Select', choose the files, then 'More' > 'Copy Items', and 'Paste' into a folder in 'On My [device]'. On a Mac, use 'Edit' > 'Copy' and paste outside iCloud Drive. Until a file has finished uploading, avoid these steps:
- Turning off 'Sync this iPhone', 'Sync this iPad' or 'Sync this Mac'. On a Mac you can choose to keep a local copy, which goes to a folder called 'iCloud Drive (Archive)' in your home folder.
- Signing out of iCloud. Apple says your iCloud data will be removed from your device unless you choose to keep a copy when prompted.
- 'Remove Download' on iPhone, iPad and Mac, or 'Free up space' on Windows. Apple describes these as safe because the file stays in iCloud, which isn't yet true of a file that is still waiting.
- Deleting the file and adding it again, unless you have a copy elsewhere.
Cause 1: Your iCloud storage is full
If you see 'Out of Space' beside a file, or the same icon next to iCloud Drive in the Finder sidebar, iCloud doesn't have enough room left. Apple says that when you run out, iCloud Drive and other iCloud apps won't stay up to date across your devices. Your file isn't lost: Apple says the document stays on your Mac and is uploaded when space becomes available. The free plan is 5 GB, and it is shared with photos, backups and Mail attachments.
Be careful when you clear space. Deleting an item from iCloud Drive removes it from all your devices, and Files keeps it in 'Recently Deleted' for only 30 days. If you exceed your storage limit, Apple warns that photos and videos you delete are removed immediately and can't be recovered. Deleting a device's backup turns off iCloud Backup for that device. Apple suggests copying your content before you delete anything.
- iPhone or iPad: go to 'Settings' > your name > 'iCloud' and look at 'Storage' (it may read 'Manage Account Storage'). On iOS 17 or iPadOS 17 and later, 'Recommended for You' on the same screen suggests what to clear.
- Mac: go to 'System Settings' > your name > 'iCloud' > 'Manage'.
- Windows: open iCloud for Windows and click 'Storage'. To change your plan, click 'Manage', then 'Change Storage Plan'.
- To buy more room on an iPhone with iOS 27 or later: 'Settings' > your name > 'iCloud' > 'Manage Plan', or 'Storage' > 'Get More Storage' for a first plan. Apple notes the steps differ on earlier versions. iCloud+ comes in 50 GB, 200 GB, 2 TB, 6 TB and 12 TB.
Cause 2: The file or folder is over the 50 GB limit
If the status says 'Ineligible', the folder or file could not be stored in iCloud. Apple says this is usually because it exceeds the 50 GB limit for an individual folder or file in iCloud Drive. The limit applies to a single folder as well as a single file, so a large project folder can hit it even when every file inside is small.
This is a different problem from a full account. Apple's help offers no specific fix beyond a link to its page on freeing up storage, so the practical options are to split a big folder into smaller ones, make the file smaller, or keep it somewhere other than iCloud Drive.
Cause 3: Your connection, or Apple's service
Apple says your files sync with iCloud each time your device connects to the internet, so check the connection first. Open a web page on the same device. Then check Apple's side: its iCloud help makes the System Status page at apple.com/support/systemstatus the first step, to make sure no outages or scheduled maintenance are currently affecting iCloud. If iCloud has a problem, wait.
On cellular, your settings may be keeping iCloud Drive on Wi-Fi only. In 'Settings' > 'Cellular' ('Cellular Data' on iPad), scroll to the list of apps and services. Apple says that when cellular data is off for an app, the device uses only Wi-Fi for that service. Its guide doesn't say which services appear in the list, so look for iCloud Drive and Files there.
A quick test: try the upload button at icloud.com/iclouddrive with a small file. If that works, iCloud is reachable, so the problem is more likely on the device. Also check:
- 'Cellular Data' itself is turned on, if you rely on cellular.
- You are signed in with the same Apple Account on all your devices. A device on a different account won't show your files.
- The device is on the latest iOS, iPadOS or macOS, which is also on Apple's iCloud checklist.
Cause 4: Low Data Mode or Low Power Mode
Apple says Low Power Mode 'reduces background activity', and its list includes 'Turns off automatic downloads' and 'Turns off Background App Refresh'. Its Low Data Mode page says that for iCloud it 'pauses updates and automatic backups, turns off iCloud Photos updates'. Neither page names iCloud Drive specifically, so treat these as something to rule out rather than a confirmed cause. Turning them off takes seconds and doesn't touch your files.
- Low Data Mode on Wi-Fi: 'Settings' > 'Wi-Fi', tap the Info button next to your network and turn off 'Low Data Mode'. Apple says iCloud keeps this preference for each network up to date across your devices.
- Low Data Mode on cellular: 'Settings' > 'Cellular' > 'Cellular Data Options'. On 5G, tap 'Data Mode' and choose another option. On LTE or 4G, turn off 'Low Data Mode'. Settings can vary by carrier.
- Low Data Mode on a Mac: 'System Settings' > 'Wi-Fi', click 'Details' next to your network and turn off 'Low data mode'.
- Low Power Mode on iPhone 15 and later: 'Settings' > 'Battery' > 'Power Mode'. On iPhone 14 and earlier: 'Settings' > 'Battery'. Apple says it turns off by itself once you charge to 80 percent or higher.
- Low Power Mode on a Mac: 'System Settings' > 'Battery' ('Energy' on a desktop Mac), then under 'Energy Mode' check the 'On battery' and 'On power adapter' menus.
On Windows: what's different in iCloud for Windows
The storage, size and connection causes above still apply. Windows also has a cause of its own: long names.
- See the progress: click the iCloud icon in the Windows Notification Area, or 'Show hidden icons' if it isn't there. Apple says this shows your iCloud uploads and downloads, although that note sits on an iCloud Photos page.
- Don't rely on File Explorer's icons. Apple's list covers download and sharing status, and has no upload status.
- Look for a notification that some of your files in iCloud Drive won't be synced. Each file, folder and subfolder name in the path must be less than 256 characters. The notification shows the path, so you can find the item and rename it.
- Update iCloud for Windows. Apple says that in version 10.8 or later only the file with the long name fails to sync. In version 10 or earlier, it stops every file in that folder.
- Copy before you sign out. Apple's sign-out steps for iCloud for Windows don't say what happens to files that haven't uploaded, so don't assume they will stay.
How to stop it happening next time
Most stuck uploads can be seen coming. A few habits help:
- Check your free iCloud space before you add anything large.
- Keep single files and folders under 50 GB.
- Run large uploads on Wi-Fi, plugged in, with Low Data Mode and Low Power Mode off.
- Confirm a file has finished uploading before you delete the original or choose 'Remove Download'.
- Keep a separate copy of anything you can't afford to lose. Apple describes an archive as one more way to keep an extra copy of your information.
If you only need to get a file to someone
If a stuck upload is holding up a file someone is waiting for, OneSol Send can hand it over by link: it takes files up to 5 GB and the recipient doesn't need to sign in. You need a free OneSol account to send, and files are kept for 3 days, so it is for delivering a file, not for storing or syncing it.