keepcalculator

06 Numbers and Powers

iCloud Not Downloading Files on Mac? Fixes That Work

Card No. 06·21447 · Updated · Standard formula, shown below

If your Mac is stuck showing greyed-out iCloud files that never download, the fix is usually a combination of checking your internet connection, toggling iCloud Drive settings, and restarting the sync process. This article walks you through the most common causes and step-by-step solutions to get your files downloading again.

Why iCloud Files Get Stuck on Mac

iCloud Drive on macOS is designed to keep your files in the cloud and only download them when you need them. This is called “Optimize Mac Storage” and it helps save space on your hard drive. However, this system can sometimes fail, leaving files with a grey cloud icon that never downloads. Common reasons include:

  • A weak or unstable internet connection
  • iCloud Drive sync being paused or stuck
  • Outdated macOS or iCloud settings
  • Insufficient local storage space
  • Corrupted cache or temporary files
  • Battery saver or low power mode interfering with background downloads

How iCloud Downloads Work on Mac

When you open a file that is stored only in iCloud, macOS automatically downloads it to your Mac. The file then appears with a grey cloud icon in Finder until the download is complete. Once downloaded, the icon changes to a green checkmark or the file opens normally. If the download doesn’t start or gets stuck, you will see the grey cloud icon indefinitely.

You can check which files are stored locally by looking at the iCloud Drive folder in Finder. Files with a grey cloud icon are not on your Mac yet. Files with a green checkmark are available offline. You can also right-click a file and select “Download Now” to force a download.

Basic Troubleshooting Steps

Before diving into more complex fixes, try these simple steps:

  1. Check your internet connection. Open a web page in Safari to ensure you are online. If you have a weak Wi-Fi signal, move closer to your router or try a wired connection.
  2. Restart your Mac. Sometimes a fresh start clears temporary glitches.
  3. Sign out and back into iCloud. Go to System Settings > Apple ID > iCloud, then click “Sign Out.” Restart your Mac and sign back in. This forces iCloud to re-sync.
  4. Check iCloud status. Visit Apple’s System Status page to see if iCloud Drive is experiencing an outage.

Force Download Specific Files

If only a few files are stuck, you can force them to download individually:

  1. Open the iCloud Drive folder in Finder.
  2. Right-click the file that is stuck.
  3. Select “Download Now” from the context menu.
  4. Wait a few minutes and check if the file downloads.

If the file still doesn’t download, try moving it to a different folder (like Documents) and then back. This sometimes triggers a fresh download request.

Check Storage Space and Optimize Settings

If your Mac’s hard drive is nearly full, iCloud may not download new files because there isn’t enough space. To check your storage:

  1. Click the Apple menu > About This Mac > Storage.
  2. If you have less than 10% free space, try deleting unnecessary files or moving them to an external drive.
  3. Go to System Settings > Apple ID > iCloud > iCloud Drive, then click “Options.”
  4. Make sure “Optimize Mac Storage” is enabled. This allows macOS to manage local storage automatically.

If you have plenty of space but files still won’t download, try disabling and re-enabling iCloud Drive:

  1. Go to System Settings > Apple ID > iCloud.
  2. Turn off iCloud Drive.
  3. Wait a few seconds, then turn it back on.

Reset iCloud Sync and Cache

Sometimes the iCloud sync process gets stuck. Resetting it can help:

  1. Quit all apps that might be using iCloud files (like Pages, Numbers, or Preview).
  2. Open Terminal (found in Utilities folder).
  3. Type killall bird and press Enter. This stops the iCloud sync daemon.
  4. Type killall cloudd and press Enter.
  5. Restart your Mac. The sync daemons will restart automatically.

If that doesn’t work, you can also clear the iCloud cache:

  1. Open Finder and press Cmd+Shift+G.
  2. Type ~/Library/Caches/CloudKit/ and press Enter.
  3. Move the contents of that folder to the Trash (do not delete the folder itself).
  4. Restart your Mac.

Note: Clearing the cache may cause iCloud to re-download some metadata, but it won’t delete your actual files.

Update macOS and iCloud Settings

Apple regularly releases updates that fix bugs, including iCloud sync issues. To check for updates:

  1. Go to System Settings > General > Software Update.
  2. If an update is available, click “Update Now.”
  3. After updating, restart your Mac and try downloading the file again.

Also, make sure your iCloud settings are correct:

  • Go to System Settings > Apple ID > iCloud.
  • Ensure iCloud Drive is enabled.
  • Click “Options” and make sure the apps you want to sync (like Desktop & Documents) are checked.

Frequently Asked Questions

Why do my iCloud files show a grey cloud icon and never download?

This usually means the file is stored only in iCloud and your Mac hasn’t downloaded it yet. It could be due to a poor internet connection, a paused sync, or a temporary glitch. Try the steps above, especially forcing a download or restarting your Mac.

How do I make all iCloud files download to my Mac?

You can’t force all files to download at once, but you can select multiple files in Finder and right-click > “Download Now.” Alternatively, you can disable “Optimize Mac Storage” in iCloud Drive settings, which tells macOS to keep all files downloaded locally. Note that this may use a lot of disk space.

Will deleting a file from iCloud Drive delete it from my Mac?

Yes, if you delete a file from iCloud Drive, it will be removed from all your devices, including your Mac. If the file is only in iCloud and not downloaded locally, deleting it will permanently remove it from iCloud. You can recover it from the Recently Deleted folder for 30 days.

Why is iCloud downloading so slow on my Mac?

Slow downloads are usually due to your internet connection speed, the size of the file, or iCloud server load. Try pausing and resuming the download, or connect to a faster network. You can also check if other apps are using bandwidth.

What does “Download Now” do in iCloud Drive?

“Download Now” forces the selected file to download from iCloud to your Mac immediately. This is useful when a file won’t download automatically or when you need to work offline. After downloading, the file will have a green checkmark and be available offline.

Can I use iCloud Drive on Windows?

Yes, Apple provides iCloud for Windows, which lets you access iCloud Drive files on a PC. However, some features like “Optimize Mac Storage” are Mac-only. If you’re having trouble on Windows, make sure you have the latest iCloud for Windows app installed.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →