iCloud Offline Files Missing

When you lose internet connectivity, you may notice that files inside your iCloud Drive folder disappear or display a cloud icon with a download arrow, rendering them inaccessible offline. This issue occurs when local storage optimization systems offload files to reclaim space, or when local offline caches are corrupted.

This guide explains how to prevent files from being offloaded, force download assets for permanent offline use, and resolve cache errors on macOS and Windows.

---

1. Understand offline file eviction in iCloud

Files are evicted from local storage due to:

• “Optimize Storage” Feature: When enabled, macOS automatically offloads older or larger files to iCloud if your disk starts filling up.
• Windows Storage Sense Cleanup: Windows Storage Sense can treat iCloud virtual file packages as temporary files, deleting local copies during cleanup tasks.
• Corrupt Database Headers: When offline, the operating system relies on local SQLite index headers. If these headers are corrupt, the file manager hides files until a connection is restored to fetch the online index.

---

2. macOS: Disable Optimize Storage and locate offline caches

On macOS, you can force the system to store all files locally and locate missing files in the system library caches.

Step 1: Disable “Optimize Mac Storage”

To ensure macOS does not delete files from your local disk:

1. Open System Settings → Apple ID → iCloud.
2. Toggle off Optimize Mac Storage. (Note: Finder will immediately start downloading all files to your local drive. This may take time depending on your data volume).

Step 2: Force Download Files via Terminal

Ensure all files in iCloud are downloaded locally:

1. Open Terminal.
2. Run this command to read all placeholder files, forcing Finder to download them:

   find ~/Library/Mobile\ Documents/com~apple~Clouddocs -type f -name "*.icloud" -exec cat {} > /dev/null \;

Step 3: Access Offline Files in Sandboxed Containers

If Finder hides files when offline, search for them in the raw sandbox directories:

1. Run this command to view cached copies of files:

   ls -R ~/Library/Mobile\ Documents/com~apple~Clouddocs/

---

3. Windows: Pin files to local disk and configure Storage Sense

On Windows, you can use PowerShell to pin files locally and adjust Windows storage cleanup settings.

Step 1: Pin iCloud Files to Disk using PowerShell

1. Open PowerShell.
2. Force the filesystem driver to pin your entire iCloud Drive directory:

   Get-ChildItem -Path "$env:USERPROFILE\iCloudDrive" -Recurse | ForEach-Object { attrib +p $_.FullName }

   (The +p flag pins the files, preventing the OS from offloading them to the cloud).

Step 2: Exclude iCloud from Windows Storage Sense

1. Open the Start Menu, type Storage Sense, and select Storage settings.
2. Click Configure Storage Sense or run it now.
3. Under Cloud Content, locate iCloud Drive and set Run storage sense to Never for cloud files.

Step 3: Clear the Windows AppData Cache

1. If the offline database is corrupt, clear the cache directory:

   taskkill /f /im iCloudDrive.exe
   rmdir /s /q "%LOCALAPPDATA%\Packages\AppleInc.iCloud_sr379ee5v9y2t\LocalState"

2. Relaunch iCloud from the Start Menu.

---

4. Restore offline metadata and index coherence

• Avoid Registry and Cache Cleaner Apps: Avoid using registry or cache cleaners (like CCleaner or CleanMyMac) on default settings. These utilities can target the hidden metadata folders of cloud drives, deleting local placeholder files.
• Check File Size Allocations: If your local hard drive does not have enough space to store your entire iCloud storage quota, the OS will ignore your request to disable storage optimization. Free up disk space on your local drive to resolve this.

---

5. Summary Checklist for iCloud Offline Files Missing

Action / Platform	macOS Command	Windows Command	Expected Outcome
Disable Offloading	Turn off “Optimize Mac Storage”	Turn off Storage Sense for cloud files	Keeps all files on the local drive.
Pin All Files	find . -name "*.icloud" -exec cat {} > /dev/null \;	attrib +p [Files] (PowerShell)	Force-downloads all files for offline use.
Browse Raw Cache	ls -R ~/Library/Mobile\ Documents	dir "%USERPROFILE%\iCloudDrive" /a	Accesses files directly in the filesystem.
Restart Sync	killall bird	taskkill /f /im iCloudDrive.exe	Restarts the sync service.
Storage Check	Free up space on boot drive	Free up space on boot drive	Prevents the OS from offloading files.
Exclusions	Exclude iCloud from cache cleaners	Exclude iCloud from cache cleaners	Protects local metadata caches.