keepcalculator

06 Numbers and Powers

Clear OneDrive Cache on Mac: Full Guide

Card No. 06·70764 · Updated · Standard formula, shown below

To clear the OneDrive cache on a Mac, quit OneDrive, delete the contents of the ~/Library/Caches/com.microsoft.OneDrive folder, and restart the app. This removes temporary thumbnail and sync files without deleting your actual cloud files, often fixing sync errors and freeing disk space.

What the OneDrive Cache Actually Contains

OneDrive on macOS stores more than just downloaded file copies. The cache folder holds:

  • Thumbnail previews of photos and documents
  • Temporary files used during uploads and downloads
  • Sync logs and diagnostic data
  • Local copies of files marked “available on this device”

These files help OneDrive display previews quickly and resume interrupted transfers. Over time, the cache can become corrupted or bloated, leading to sync failures, high CPU usage, or odd “changes pending” states that never resolve.

Why Clearing the Cache Helps

Corrupted cache entries are a common cause of OneDrive problems on Mac. Symptoms include:

  • Files stuck in “Processing changes” for hours
  • OneDrive using excessive memory or CPU
  • Thumbnails not loading or showing blank icons
  • Sync errors with no clear explanation

Clearing the cache forces OneDrive to rebuild these temporary files from your cloud data. It does not delete any files from your OneDrive account or from your Mac’s normal OneDrive folder (the one in your user directory). It only removes the hidden cache folder, which OneDrive recreates automatically.

Step-by-Step: Clear OneDrive Cache on Mac

  1. Quit OneDrive completely. Click the OneDrive icon in the menu bar, then select Quit OneDrive. If it doesn’t quit, open Activity Monitor and force-quit any process named OneDrive.
  2. Open Finder and press Cmd+Shift+G to bring up “Go to Folder.”
  3. Type ~/Library/Caches and press Enter. This opens the Caches folder for your user account.
  4. Find the folder named com.microsoft.OneDrive. Right-click it and select Move to Trash.
  5. Restart OneDrive from the Applications folder. It will recreate the cache folder and re-sync your files.

If you want to be extra thorough, you can also clear the ~/Library/Application Support/OneDrive folder, but this contains settings and account data. Only do this if you’re willing to sign in again and reconfigure preferences.

What to Do If Clearing the Cache Doesn’t Fix It

Sometimes the cache isn’t the root cause. If sync problems persist after clearing the cache:

  • Check your internet connection and firewall settings.
  • Ensure you have enough free disk space on your Mac.
  • Try pausing and resuming sync from the OneDrive menu bar icon.
  • Sign out of OneDrive and sign back in. This resets the sync relationship without deleting local files.
  • If files are stuck, move them out of the OneDrive folder, let the folder sync, then move them back.

If none of these work, the issue may be a server-side problem or a conflict with another app. Contact Microsoft support or check the OneDrive status page.

How Cache Clearing Affects Your Files

Your actual files are safe. The cache folder is separate from the ~/OneDrive folder where your synced files live. Clearing the cache only removes temporary data, so your documents, photos, and folders remain untouched. After restarting, OneDrive will re-download any files that were marked “available on this device” and rebuild thumbnails. This may take some time and bandwidth, especially if you have a large library.

Files that are “online-only” (cloud-only) will not be downloaded; they stay in the cloud and appear as placeholders. The cache only stores their thumbnail and metadata, which will be re-fetched as needed.

Frequently Asked Questions

Will clearing the OneDrive cache delete my files?

No. The cache folder contains temporary files, not your actual documents. Your OneDrive folder and cloud files are not affected. Only the cache is removed, and OneDrive recreates it automatically.

How often should I clear the OneDrive cache?

Only when you experience issues like sync errors, high CPU usage, or corrupted thumbnails. There’s no need to clear it on a schedule. If you frequently have problems, consider signing out and back in instead.

Can I clear the OneDrive cache while OneDrive is running?

It’s best to quit OneDrive first. If you delete files while the app is running, it may recreate them immediately or cause a conflict. Quit OneDrive, clear the cache, then restart.

Does clearing the cache free up space on my Mac?

Yes, but usually only a small amount. The cache typically holds thumbnails and temporary files, which can add up to a few hundred megabytes. If you need significant space, use OneDrive’s “Free up space” feature to convert files to online-only.

What’s the difference between clearing the cache and resetting OneDrive?

Clearing the cache only removes temporary files. Resetting OneDrive (via signing out and back in, or using the reset command) rebuilds the entire sync database and re-downloads metadata. Resetting is more thorough and can fix deeper issues, but takes longer.

Is it safe to delete the entire com.microsoft.OneDrive folder?

Yes. OneDrive will recreate it on next launch. Just make sure OneDrive is not running when you delete it. If you’re nervous, drag it to the Trash and empty the Trash after OneDrive has restarted successfully.

Alternatives to Manual Cache Clearing

If you’re not comfortable using Terminal or Finder, you can try:

  • OneDrive’s built-in reset: Quit OneDrive, then run /Applications/OneDrive.app/Contents/Resources/ResetOneDriveApp.command in Terminal. This resets the app without deleting your files.
  • Reinstalling OneDrive: Uninstall and reinstall the app. This clears all local data, including cache and settings, but you’ll need to sign in again.
  • Using a cleanup tool: Some Mac cleaning apps can clear caches for you, but they may not target OneDrive specifically. Manual clearing is more reliable.

These methods are more invasive but can resolve persistent issues that cache clearing alone won’t fix.

Common Misconceptions

One common myth is that clearing the cache will delete your local files. As explained, that’s false. Another misconception is that you need to clear the cache to free up space when OneDrive is set to “Download all files.” In that case, the actual files are in your OneDrive folder, not the cache. To free space, you should change the sync settings to “Online-only” for folders you rarely use.

Also, some users think clearing the cache will speed up OneDrive significantly. In reality, it only helps if the cache is corrupted or bloated. For general speed, ensure your Mac has enough RAM and a stable internet connection.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →