Dropbox Sync Icons Missing
Resolution Checklist
- 1 Understand why Dropbox sync status icons disappear
- 2 Resolve Windows File Explorer overlay limit issues
- 3 Fix macOS Finder sync icon overlay crashes
- 4 Configure and force reload the system shells
- 5 Summary Quick Reference Checklist
Dropbox Sync Icons Missing
Sync icons (such as the green checkmarks for downloaded files, blue sync loops for files in progress, and gray clouds for online-only files) are critical for tracking file status. When these icons disappear, it is difficult to know if files are fully synced. This issue occurs due to operating system shell limits or integration plugin crashes.
This guide provides steps and commands to resolve missing sync icons in Windows File Explorer and macOS Finder.
1. Primary Causes of Missing Sync Icons
Sync icons disappear due to operating system shell constraints:
- Windows Shell Overlay Limit (15-Slot Limit): Windows only supports a maximum of 15 system-wide icon overlays. Other cloud services (like OneDrive, iCloud, and Google Drive) or developer tools (like Git or TortoiseSVN) register their own overlays. Because Windows processes these alphabetically, Dropbox overlays are ignored if they fall past slot 15.
- Disabled Finder Extension (macOS): macOS relies on the Dropbox Finder Extension to render icons in Finder windows. If this extension crashes or is disabled, icons will fail to display.
- Corrupted Shell Icon Cache: A corrupted OS icon cache can prevent new overlays from loading.
2. Resolve Windows File Explorer Overlay Limits
On Windows, you must check the Registry to see which overlay keys are occupying the 15 available slots. You can rename the Dropbox keys (prefixing them with spaces) to prioritize them alphabetically.
A. List Installed Registry Overlays via PowerShell
- Search for PowerShell in the Start Menu, right-click, and select Run as Administrator.
- Run this command to inspect the registered overlays:
# List all registered icon overlays in alphabetical order Get-ChildItem -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers" | Select-Object Name
Note: The keys at the top of the alphabetical list get prioritized. If OneDrive or other services occupy the top slots (often using spaces or special characters in their names), Dropbox overlays will not render.
B. Apply the Registry Fix to Prioritize Dropbox
To prioritize Dropbox, rename the Dropbox registry entries so they start with spaces (e.g., " DropboxExt1").
- Press
Win + R, typeregedit, and press Enter. - Navigate to:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers - Right-click the Dropbox keys (usually named
DropboxExt1,DropboxExt2, etc.) and select Rename. - Add 3 spaces to the beginning of each Dropbox key name.
- Restart your computer or restart Explorer:
:: Relaunch Explorer to reload Registry overlay keys taskkill /f /im explorer.exe start explorer.exe
3. Fix macOS Finder Sync Icon Overlays
On macOS, sync icons are driven by the garcon Finder extension plugin. If it stops responding, you can re-register the plugin and relaunch Finder.
A. Re-register and Restart the Finder Extension
- Open Terminal (via Cmd + Space, type
Terminal). - Run this command block to force the Finder extension to reload:
# Kill Finder to clear cached visual layers killall Finder # Re-enable the Dropbox Finder plug-in extension pluginkit -e use -i com.getdropbox.dropbox.garcon # Force macOS Finder to restart and load the extension open /System/Library/CoreServices/Finder.app
B. Verify Finder Extension Permissions
- Go to System Settings > Privacy & Security > Extensions.
- Select Finder extensions.
- Verify that Dropbox is toggled ON.
4. Rebuild the System Icon Cache
If icons still fail to display, rebuilding the operating system’s local icon cache will clear out corrupted image databases.
Rebuild Windows Icon Cache
Run this command in an Administrator Command Prompt:
:: Kill Explorer shell
taskkill /f /im explorer.exe
:: Navigate to cache location and delete the db files
cd /d %userprofile%\AppData\Local\Microsoft\Windows\Explorer
attrib -h iconcache_*.db
del iconcache_*.db /f /q
:: Restart Explorer shell
start explorer.exe5. Summary Quick Reference Checklist
| Action Target | Operating System | Terminal Command / Registry Path | Expected Outcome |
|---|---|---|---|
| Inspect Overlays | Windows | HKLM\...\Explorer\ShellIconOverlayIdentifiers | Checks if Dropbox falls outside the 15-slot limit. |
| Prioritize Dropbox | Windows | Rename Dropbox keys by adding spaces to their prefixes | Forces Windows to process Dropbox overlays first. |
| Relaunch Explorer | Windows | taskkill /f /im explorer.exe | Reloads Explorer to apply registry changes. |
| Enable Finder Plugin | macOS | pluginkit -e use -i com.getdropbox.dropbox.garcon | Forces macOS Finder to load Dropbox icon overlays. |
| Relaunch Finder | macOS | killall Finder | Re-initializes Finder window integrations. |
| Rebuild Cache | Windows | Delete iconcache_*.db in AppData | Recreates corrupted Windows thumbnail and icon indexes. |