dropbox

Dropbox Storage Full

Resolution Checklist

  • 1 Understand the Dropbox storage quota allocation rules
  • 2 Analyze space usage and locate large files on Windows
  • 3 Analyze space usage and locate large files on macOS
  • 4 Purge the hidden local Dropbox cache to reclaim local disk space
  • 5 Leave shared folders to free up cloud storage
  • 6 Summary Quick Reference Checklist

Dropbox Storage Full

When you hit your Dropbox storage limit, synchronization halts immediately. Dropbox will show “Storage Full” warnings, and any files modified or added will remain unsynced (displaying a red exclamation point or sync badge). Additionally, a full local disk can block Dropbox from downloading files even if your cloud account has plenty of room.

This guide outlines how to inspect your quota, locate space-hogging files, and clear hidden cache files on both Windows and macOS.

1. How Dropbox Storage Quota Works

To troubleshoot storage issues, it is important to understand Dropbox’s storage policies:

  • Shared Folders Count Against Your Quota: If someone shares a 10 GB folder with you, it consumes 10 GB of your personal account storage. Only Dropbox Teams/Business plan folders are exempt from counting against individual quotas.
  • Version History Storage: File history and deleted files do not count against your cloud storage quota.
  • Local Disk vs. Cloud Space: If your computer’s C:\ drive or macOS startup disk is full, Dropbox cannot sync, regardless of how much space remains in your cloud account.

2. Analyze Space Usage and Locate Large Files (Windows)

Use PowerShell to search your local Dropbox folder and identify the largest files that are consuming your storage.

  1. Search for PowerShell in the Start Menu and open it.
  2. Run this command block to list the 20 largest files in your Dropbox: 
    # Scan Dropbox and sort files by size
$dropboxPath = "$HOME\Dropbox"
Write-Host "Scanning '$dropboxPath' for large files..." -ForegroundColor Cyan

Get-ChildItem -Path $dropboxPath -Recurse -File -ErrorAction SilentlyContinue | 
Sort-Object Length -Descending | 
Select-Object -First 20 Name, @{Name="Size (MB)";Expression={[Math]::Round($_.Length / 1MB, 2)}}, FullName | 
Format-Table -AutoSize

Action: Delete unwanted files or move them outside your Dropbox folder to reclaim space.

3. Analyze Space Usage and Locate Large Files (macOS)

Use macOS Terminal and standard shell utilities to find the largest directories and files in your Dropbox.

  1. Open Terminal (via Cmd + Space, type Terminal).
  2. Run this command block to find the 20 largest files: 
    # Scan Dropbox folder and sort by file size in human-readable format
echo "Scanning Dropbox folder for large files..."
find ~/Dropbox -type f -exec du -ah {} + 2>/dev/null | sort -rh | head -n 20

To scan for the largest folders rather than individual files:

# Scan and display folder sizes in the Dropbox directory
du -sh ~/Dropbox/* 2>/dev/null | sort -rh | head -n 10

4. Purge the Hidden Local Dropbox Cache

The local Dropbox app caches files in a hidden directory named .dropbox.cache to enable fast recovery of recently deleted files. Over time, this folder can grow to tens of gigabytes, consuming critical local disk space.

Purge Cache on Windows

Run these commands in Command Prompt to clear the hidden cache folder:

:: Delete hidden cache contents
rmdir /s /q "%USERPROFILE%\Dropbox\.dropbox.cache"

Purge Cache on macOS

Run this command in Terminal:

# Force delete all items inside the hidden cache folder
rm -rf ~/Dropbox/.dropbox.cache/*

5. Leave Unneeded Shared Folders to Free Cloud Storage

If your cloud storage is full due to shared folders, leaving them will immediately restore your quota.

  1. Sign in to Dropbox.com.
  2. Click Shared in the left sidebar.
  3. Find folders you no longer need.
  4. Click the ellipsis (…) next to the folder and select Remove from Dropbox.
  5. The folder and its files will be deleted from your account, and your quota will be adjusted instantly.

6. Summary Quick Reference Checklist

Action TargetOperating SystemLocation / CommandExpected Outcome
Check Cloud QuotaWeb Browserhttps://www.dropbox.com/account/planShows detailed breakdown of cloud storage usage.
Find Large FilesWindowsPowerShell script in Section 2Lists the 20 largest files in your Dropbox.
Find Large FilesmacOSTerminal script in Section 3Lists the 20 largest files in your Dropbox.
Purge Local CacheWindowsrmdir /s /q "%USERPROFILE%\Dropbox\.dropbox.cache"Reclaims physical disk space on the C:\ drive.
Purge Local CachemacOSrm -rf ~/Dropbox/.dropbox.cache/*Reclaims physical disk space on the startup drive.
Leave Shared FoldersWeb BrowserWeb Portal > Shared > RemoveReclaims cloud space consumed by shared data.
Offload via Smart SyncWindows / macOSRight-click folder > Make Online-onlyFrees local drive space without deleting cloud files.