How to Clear OneDrive Cache (And When It Actually Matters)

OneDrive is quietly doing a lot of work in the background — syncing files, tracking changes, maintaining local copies. That's generally seamless, but over time the cache it builds up can cause sync errors, slow performance, or stubborn glitches that don't respond to the usual fixes. Knowing how to clear it — and understanding what you're actually clearing — makes the difference between a quick fix and an afternoon of frustration.

What Is the OneDrive Cache, Exactly?

OneDrive uses several types of stored data to do its job efficiently:

• Sync database files that track which files are up to date between your device and the cloud
• Thumbnail and preview caches used by Windows Explorer to display file icons quickly
• Temporary upload/download buffers for files mid-transfer
• Credential tokens that keep you logged in

When any of these become corrupted or out of sync with what's actually in the cloud, problems follow — duplicate files, files stuck in "syncing" loops, or OneDrive refusing to connect at all.

Clearing the cache doesn't delete your actual files from the cloud. It resets OneDrive's local tracking so it can rebuild from a clean state. That distinction matters before you start.

Method 1: Reset OneDrive Using the Built-In Reset Command

This is the most thorough option for Windows users and addresses the core sync database.

Steps:

1. Press Windows + R to open the Run dialog
2. Type or paste the following and press Enter:

   %localappdata%MicrosoftOneDriveonedrive.exe /reset 

3. OneDrive will close. Wait 1–2 minutes, then reopen it manually from the Start menu or system tray
4. If it doesn't reopen automatically, run the same path without /reset to launch it fresh

This command resets OneDrive's sync engine — effectively wiping its local index and forcing it to re-read everything from the cloud. It's the equivalent of a factory reset for the sync process, not for your files.

⚠️ Expect OneDrive to spend time re-syncing after this. On large libraries, that can take a while depending on your connection.

Method 2: Clear the Thumbnail and File Cache

If your issue is visual — corrupted icons, blank thumbnails, stale previews — the problem may sit in Windows' general thumbnail cache rather than OneDrive's sync files.

Steps:

1. Open Disk Cleanup (search it in the Start menu)
2. Select your system drive (usually C:)
3. Check Thumbnails in the list
4. Run the cleanup

Alternatively, through Settings → System → Storage → Temporary Files, you can clear the same data without the older Disk Cleanup interface.

This won't affect your synced files or OneDrive's connection — it only refreshes how your file system displays them.

Method 3: Delete OneDrive's Local Cache Folder Manually

For persistent issues, some users clear the cache folder directly.

The location on Windows:

%localappdata%MicrosoftOneDrivecache 

Steps:

1. Fully quit OneDrive from the system tray (right-click → Quit)
2. Navigate to the path above in File Explorer
3. Delete the contents of the folder (not the folder itself)
4. Restart OneDrive

This targets stored temporary data more directly than the reset command, and it's useful when the reset alone hasn't resolved an issue.

OneDrive Cache on Mac

The process works differently on macOS. OneDrive stores its local data in:

~/Library/Containers/com.microsoft.OneDrive-mac 

To reset:

1. Quit OneDrive completely from the menu bar
2. Open System Settings → Privacy & Security → Full Disk Access and confirm OneDrive has access
3. Navigate to the container folder in Finder (use Go → Go to Folder)
4. Move its contents to Trash, then empty
5. Relaunch OneDrive and sign back in

On Mac, a full cache clear typically requires signing back into your account, since credential data lives in the same space as sync data.

OneDrive on Mobile (iOS and Android)

Mobile cache clearing is handled at the OS level, not within OneDrive itself.

On Android, Clear Cache and Clear Data are separate options — clear data will sign you out and wipe local files, while clear cache is the safer starting point. On iOS, there's no standalone cache-clear option; offloading and reinstalling the app achieves a similar result.

Variables That Affect What You Should Do 🔧

The right approach isn't the same for everyone. A few factors shift which method is worth trying first:

• How much is in your OneDrive library — a reset on a 500GB sync library means hours of re-syncing versus minutes for a small personal account
• Whether you use OneDrive for Business vs. personal — business accounts with SharePoint-backed libraries sometimes behave differently during reset, and your IT admin may have policies in place
• What the actual symptom is — a stuck sync icon, a sign-in loop, and corrupted thumbnails each point to different parts of the cache
• Windows version and OneDrive build — the reset command path can vary slightly across older Windows 10 builds versus Windows 11, and Microsoft has updated the client architecture over the years

Someone running OneDrive as a primary work tool with thousands of shared files faces a meaningfully different situation than someone using it for basic photo backup on a personal laptop. The methods above are the same, but the stakes and timing of each step vary significantly based on what's actually being synced and how critical continuity is to that person's setup.