Home › Knowledgebase › KB-1510

How To Clear Onedrive Sync Cache

Summary

This guide helps you troubleshoot and resolve: How To Clear Onedrive Sync Cache. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

Instructions

Important warning: Before clearing your OneDrive cache, ensure all files are fully synchronised to the cloud. Any unsynced local changes may be lost during this process. We strongly recommend backing up important local files to an external drive or secondary location before proceeding.

OneDrive is designed to keep your files synchronised across your devices, but occasionally the local sync cache can become corrupted or bloated. You might notice that files are marked as online-only yet your hard drive space remains full, or that edits made on one device do not appear on another. Clearing the OneDrive cache forces the sync client to rebuild its local database and resynchronise your files from the cloud. This process does not delete your documents stored in OneDrive; it only refreshes how OneDrive tracks them on your computer.

After clearing the cache, OneDrive will need to re-download all your files from the cloud. Depending on the size of your library and your internet connection, this may take several hours and consume significant bandwidth. Small business teams should plan this activity outside of peak working hours to avoid disrupting productivity.

Step 1: Check for unsynced files before clearing cache

  1. Locate the OneDrive cloud icon in the Windows system tray (bottom-right corner of your screen). You may need to click the upward-pointing arrow to reveal hidden icons.
  2. Look at the sync status indicator. If you see a spinning circle or red X, there are pending changes or errors that must be resolved first.
  3. Open OneDrive and confirm that all files show a green tick or blue cloud icon, indicating they are synchronised.
  4. If any files are stuck syncing, wait until the process completes before continuing with this guide.

Step 2: Close OneDrive

  1. Locate the OneDrive cloud icon in the Windows system tray (bottom-right corner of your screen). You may need to click the upward-pointing arrow to reveal hidden icons.
  2. Right-click the OneDrive icon.
  3. Select Quit OneDrive. If this option is not visible, select Settings, go to the Account tab, click Unlink this PC, then close the application.

Step 3: Clear the sync cache on Windows

  1. Press Windows Key + R to open the Run dialog.
  2. Type %localappdata%\Microsoft\OneDrive\settings\ and press Enter.
  3. Delete all files inside the settings folder.
  4. Navigate back to %localappdata%\Microsoft\OneDrive\.
  5. Open the user folder and delete all files inside it.
  6. Empty your Recycle Bin to ensure the temporary files are fully removed.
Deleting these folders only removes local sync metadata and temporary cache files. Your actual documents remain safe in the cloud and will be resynchronised once OneDrive restarts.

Step 4: Clear the sync cache on macOS

  1. Quit OneDrive completely. Click the OneDrive icon in the menu bar, select Settings, go to the Account tab, and click Unlink this Mac. Then quit the application.
  2. Open Finder.
  3. In the menu bar, click Go, then select Go to Folder.
  4. Enter the following path: ~/Library/Application Support/OneDrive/settings/
  5. Delete all files inside the settings folder.
  6. Navigate to: ~/Library/Application Support/OneDrive/
  7. Open the user folder and delete all files inside it.
  8. Empty the Trash to ensure the temporary files are fully removed.

Step 5: Restart OneDrive and resync

  1. On Windows, click the Start button and type OneDrive. Open the OneDrive app from the search results. On macOS, open OneDrive from your Applications folder.
  2. Sign in with your business or personal Microsoft account if prompted.
  3. Follow the setup wizard to choose which folders you wish to sync locally.
  4. Allow OneDrive to complete the initial synchronisation. Depending on the size of your library, this may take several hours.

Step 6: Verify sync status after restart

  1. Check the OneDrive status icon in the system tray (Windows) or menu bar (macOS).
  2. Ensure the status shows Up to date or Synchronising without error indicators.
  3. Open File Explorer (Windows) or Finder (macOS) and confirm that previously online-only files are re-downloading or displaying correctly.
  4. Verify that any folders you previously marked as Always keep on this device have resumed local synchronisation.

Alternative method: Use the OneDrive reset command

As an alternative to manually deleting cache folders, you can run the OneDrive reset command. This forces the client to restart and rebuild its local database.

  1. Close OneDrive completely using the steps above.
  2. Press Windows Key + R to open the Run dialog.
  3. Type the following command and press Enter: %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  4. Wait for OneDrive to close and automatically restart.
  5. Sign in again if prompted and allow the resynchronisation to complete.

Troubleshooting

OneDrive will not start after clearing the cache

Sync conflicts between devices

Files still showing as online-only

Changes still not syncing across devices

Interpreting common OneDrive error codes

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket