iCloud Files Missing

Finding that files or folders have disappeared from your iCloud Drive directory is alarming. This issue can occur when files are offloaded due to storage optimization settings, deleted by another device syncing to the same account, or hidden due to local index corruption.

This guide provides technical steps to rebuild local index directories, recover files deleted within the last 30 days, and find hidden documents on macOS and Windows.

---

1. Diagnose why files are missing in iCloud

Missing files are usually caused by:

• “Optimize Storage” Offloading: macOS and Windows may offload files to the cloud when disk space is low, leaving only tiny placeholder files. When offline, these files appear to be missing.
• SQLite Database Index De-synchronization: If the sync engine’s local database crashes, files might physically exist in cache folders but won’t be shown in Finder or File Explorer.
• Accidental Sync Deletion: A deletion action performed on one linked device syncs instantly across all devices.

---

2. macOS: Force re-index and find hidden iCloud documents

On macOS, you can find missing files by checking the raw local directory and rebuilding the sync cache.

Step 1: Check the Raw Mobile Documents Path in Terminal

Finder may hide files, but they are often still present in the local system directory:

1. Open Terminal.
2. List all files in the hidden iCloud root directory, including hidden files:

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

3. If files are there, copy them to a local directory (e.g., Desktop) to secure them:

   cp -R ~/Library/Mobile\ Documents/com~apple~Clouddocs/your_folder ~/Desktop/

Step 2: Force-Rebuild the CloudDocs Index Database

If the database is out of sync, force a full refresh:

1. Stop the sync daemon:

   killall bird

2. Delete the corrupted local indexing folder:

   rm -rf ~/Library/Application\ Support/CloudDocs

3. Open Finder and wait for the files to re-index and populate.

---

3. Windows: Unhide local files and clear file cache

On Windows, virtual files may be hidden or stuck in the local cache.

Step 1: Remove System Hidden Attributes

1. Open Command Prompt (Admin).
2. Run this command to remove system, hidden, and read-only flags from the iCloud Drive directory:

   attrib -h -r -s "%USERPROFILE%\iCloudDrive\*.*" /s /d

Step 2: Search for Missing Files in the Local Cache Folder

If Files Explorer is not displaying the files:

1. Press Windows Key + R to open Run.
2. Navigate to the local cache directory:

   %localappdata%\Packages\AppleInc.iCloud_sr379ee5v9y2t\LocalState

3. Search for your missing files or folders within this directory.

Step 3: Force Re-synchronization

1. Restart the iCloud Windows service:

   taskkill /f /im iCloudDrive.exe && start iCloudDrive.exe

---

4. Recover deleted files from the iCloud Recovery Portal

If the files were deleted from both local and cloud directories, you can restore them within 30 days of deletion:

1. Open your web browser and sign in to iCloud.com.
2. Go to Account Settings or scroll to the bottom of the page and click Data Recovery.
3. Select Restore Files.
4. Browse the list of deleted files, check the boxes next to the items you want to restore, and click Restore.

---

5. Summary Checklist for iCloud Files Missing

Diagnostic Step	macOS Command	Windows Command	Expected Outcome
Inspect Raw Files	ls -la ~/Library/Mobile\ Documents/	dir "%USERPROFILE%\iCloudDrive" /a	Verifies if files are present in the filesystem.
Force Re-index	rm -rf ~/Library/Application\ Support/CloudDocs	N/A	Re-aligns local database with the server.
Reset Attributes	N/A	attrib -h -r -s ... /s /d	Restores visibility to hidden Windows files.
Re-launch Client	killall bird	taskkill /f /im iCloudDrive.exe	Restarts the background sync threads.
Server Restoration	Restore via icloud.com web portal	Restore via icloud.com web portal	Recovers files deleted within the last 30 days.