Dropbox Smart Sync Not Working
Resolution Checklist
- 1 Identify why Smart Sync is failing to function
- 2 Repair and enable the Windows Cloud Files driver (cldflt)
- 3 Repair and enable the macOS FileProvider plugin
- 4 Verify actual vs. logical disk space usage
- 5 Summary Quick Reference Checklist
Dropbox Smart Sync Not Working
Smart Sync allows you to view and access files in your Dropbox folder without downloading them to your hard drive, saving physical disk space. When Smart Sync fails, “online-only” files will still occupy storage space, the right-click “Make online-only” option may be missing, or opening online-only files will result in system crashes or file load errors.
This guide details how to re-register the system-level syncing drivers and repair integration extensions on both Windows and macOS.
1. Primary Causes of Smart Sync Failures
Smart Sync relies heavily on operating system integrations:
- Disabled Windows Cloud Files Driver (
cldflt): Windows uses thecldflt.syskernel driver to coordinate cloud storage placeholders. If this service is disabled, Smart Sync ceases to function. - Disabled macOS FileProvider Extension: On macOS, Dropbox uses a Apple-designed extension to manage virtual folders. If this plug-in is disabled or blocked in system settings, context menu items disappear.
- Incorrect File Permissions: If the sync client cannot modify file metadata, it cannot mark files as online-only or download them on demand.
2. Repair and Enable the Windows Cloud Files Driver (cldflt)
On Windows, the primary mechanism for Smart Sync is the Cloud Files Filter driver. If this driver is stopped or disabled, Smart Sync fails. Use PowerShell to inspect and re-enable it.
A. Enable and Start the cldflt Driver
- Search for PowerShell in the Start Menu, right-click, and select Run as Administrator.
- Run this command block to verify, configure, and start the system driver:
# Check current status of the Cloud Files Filter driver $service = Get-Service -Name cldflt -ErrorAction SilentlyContinue if ($service) { Write-Host "Current cldflt Status: $($service.Status)" -ForegroundColor Cyan # Set service startup type to Automatic Set-Service -Name cldflt -StartupType Automatic # Start the service if it is stopped if ($service.Status -ne 'Running') { Start-Service -Name cldflt Write-Host "Success! Cloud Files Filter driver has been started." -ForegroundColor Green } else { Write-Host "Driver is already running." -ForegroundColor Green } } else { Write-Host "Error: cldflt driver service not found on this Windows installation." -ForegroundColor Red }
B. Force Windows Explorer to Reload Registry Extensions
If context menus are still missing, run this in command prompt:
:: Kill and restart explorer.exe
taskkill /f /im explorer.exe
start explorer.exe
3. Repair and Enable the macOS FileProvider Plugin
On macOS, context menus are handled by the Dropbox Finder Extension (codenamed garcon). Use Terminal to re-register the plugin.
A. Re-register and Force Load the Dropbox Extension
- Open Terminal (via Cmd + Space, type
Terminal). - Run these commands to reset and enable the plug-in:
# Disable and ignore the extension temporarily pluginkit -e ignore -i com.getdropbox.dropbox.garcon 2>/dev/null || true # Force-enable and use the extension pluginkit -e use -i com.getdropbox.dropbox.garcon # Verify that the extension is active (should display a '+' next to it) pluginkit -m -i com.getdropbox.dropbox.garcon # Force relaunch Finder to load the extension killall Finder
B. Approve extensions in System Settings
Ensure macOS is not blocking the extensions:
- Go to System Settings > Privacy & Security > Extensions.
- Click Added extensions (or Finder extensions).
- Ensure the checkbox next to Dropbox is enabled.
4. Verify Actual vs. Logical Disk Space
Sometimes users believe Smart Sync is not working because the “Size” of a file matches its actual size.
- Size: Represents the logical size (e.g., a 10 GB video file).
- Size on disk: Represents the physical size occupied on your drive. For online-only files, this should read 0 bytes (or a few kilobytes for NTFS/APFS metadata blocks). Verify the “Size on disk” parameter in the file properties menu (Windows) or “Get Info” panel (macOS).
5. Summary Quick Reference Checklist
| Action Target | Operating System | Terminal Command / Action | Expected Outcome |
|---|---|---|---|
| Verify Driver Status | Windows | Get-Service -Name cldflt | Checks if Windows Cloud Files driver is active. |
| Enable Cloud Driver | Windows | Set-Service -Name cldflt -StartupType Automatic | Configures the driver to run on system boot. |
| Re-enable Extension | macOS | pluginkit -e use -i com.getdropbox.dropbox.garcon | Restores context menu options. |
| Restart UI Shell | Windows | taskkill /f /im explorer.exe | Reloads File Explorer to show sync icons. |
| Restart UI Shell | macOS | killall Finder | Reloads Finder to display Smart Sync tags. |
| Verify Disk Occupancy | All OS | Properties > Size on Disk | Confirms file occupies 0 bytes of physical storage. |