iCloud Storage Full

When your iCloud storage quota is exhausted, file synchronization halts immediately. You will receive alerts saying “iCloud Storage Is Full,” files placed in your iCloud Drive will display a stalled upload status, and mail or photo backups will cease. This occurs when old backups or large application directories consume your available cloud space.

This guide provides technical steps to audit your iCloud storage, locate large files, and purge hidden cache files on macOS and Windows.

---

1. Understand iCloud storage allocations and limits

iCloud storage limits block sync operations through:

• System Quota Block: Once your account reaches 100% capacity, Apple’s servers reject all incoming file transfers.
• Hidden Mobile Backups: Old iOS backups from devices you no longer own can remain stored in your iCloud account, consuming gigabytes of space.
• App Containers Data: Apps that sync with iCloud (such as WhatsApp, email clients, or drawing tools) store hidden documents in app containers that don’t appear in your main iCloud Drive folder.

---

2. macOS: Audit and purge large files and hidden backup containers

On macOS, you can use the Terminal to find large files and view your storage breakdown.

Step 1: Scan and Sort iCloud Drive Files by Size

1. Open Terminal.
2. Run this command to list the largest files in your local iCloud Drive directory, sorted in descending order:

   du -sh ~/Library/Mobile\ Documents/com~apple~Clouddocs/* | sort -rh | head -n 20

Step 2: Identify and Clean App Containers

Some apps store heavy cache directories inside their sandboxed iCloud containers:

1. List the size of all sandbox directories:

   du -sh ~/Library/Mobile\ Documents/* | sort -rh | head -n 20

2. Locate large directories that you no longer need and delete them (replace [ContainerName] with the actual directory name):

   rm -rf ~/Library/Mobile\ Documents/[ContainerName]

Step 3: Purge Local CloudDocs Caches to Free Up Storage

1. Force close the sync engine:

   killall bird

2. Delete the local cache files to free up disk space:

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

---

3. Windows: Find large files in iCloud Drive via PowerShell

On Windows, you can use PowerShell scripts to find large files in your iCloud folder.

Step 1: Find Large Files in iCloud Drive via PowerShell

1. Open PowerShell.
2. Run this command to list the 20 largest files in your iCloud Drive folder:

   Get-ChildItem -Path "$env:USERPROFILE\iCloudDrive" -Recurse -File | Sort-Object Length -Descending | Select-Object -First 20 FullName, @{Name="Size (MB)";Expression={[Math]::Round($_.Length / 1MB, 2)}}

Step 2: Delete Old Device Backups via Command Line

If old device backups are consuming storage, delete them:

1. Navigate to the local mobile sync folder:

   cd "%APPDATA%\Apple Computer\MobileSync\Backup"

2. Delete the backup folders:

   rmdir /s /q [BackupFolderName]

Step 3: Run Disk Cleanup on Cloud Cache Files

1. Clear the local package cache:

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

---

4. Manage system backups and optimize media storage

If you cannot free up enough space by deleting files:

• Toggle Off Heavy Applications: Go to System Settings → Apple ID → iCloud → iCloud Drive → Apps syncing to iCloud Drive. Turn off apps that don’t need cloud backup.
• Optimize Photos Storage: If you sync photos, enable Optimize Storage in your Photos app settings. This replaces full-resolution photos with space-saving versions on your computer while keeping the originals in iCloud.

---

5. Summary Checklist for iCloud Storage Full

Component / Goal	macOS Command	Windows Command	Expected Outcome
Audit Files	du -sh ~/Library/Mobile\ Documents/...	PowerShell Sort-Object Length	Identifies largest files consuming space.
Audit Containers	du -sh ~/Library/Mobile\ Documents/*	N/A	Finds heavy hidden third-party app folders.
Purge Local Cache	rm -rf .../CloudDocs	Delete ...\LocalState	Cleans up storage indices.
Delete Backups	Delete in MobileSync folder	rmdir /s /q %APPDATA%\MobileSync\Backup	Removes old iOS device backups.
App Exclusions	Toggle off apps in System Settings	Toggle off apps in iCloud Panel	Stops large apps from uploading data.
Media Compression	Enable “Optimize Storage” in Photos	Enable “Optimize Storage” in iCloud	Reduces local and cloud photos footprint.