When OneDrive on your Mac stops syncing, shows errors, or behaves unexpectedly, a reset often fixes the problem. The standard reset process disconnects your account and removes local copies of cloud-only files. This can be disruptive if you rely on quick access to those files. This article explains how to reset OneDrive on a Mac while keeping all cloud files intact. You will learn the exact steps to re-link your account without losing your online data.
Key Takeaways: Reset OneDrive Without Cloud Data Loss
- OneDrive preferences > Account > Unlink this Mac: Disconnects your account but leaves all cloud files untouched on Microsoft servers.
- Re-sign-in after unlinking: Restores the sync connection and re-downloads only the files you marked as locally available.
- Back up local folders first: Prevents accidental data loss if you have files that have not yet synced to the cloud.
What Happens When You Reset OneDrive on Mac
Resetting OneDrive removes the local sync relationship between your Mac and your OneDrive for Business cloud storage. The app stops syncing, removes its cached metadata, and disconnects your Microsoft 365 account. However, the files stored on Microsoft servers remain untouched. After you sign in again, OneDrive rebuilds the local sync folder and re-downloads only the files you have set to “Always keep on this device.” Files marked as “Files On-Demand” remain as online-only placeholders until you open them.
The key distinction is between local copies and cloud storage. Unlinking does not delete anything from the cloud. It only removes the local connection. This is different from deleting files from your OneDrive folder, which would remove them from both locations. Understanding this difference helps you reset confidently without worrying about data loss.
Prerequisites Before You Reset
Before starting, ensure your Mac is connected to the internet. Verify that you know your Microsoft 365 work or school account credentials. If you use two-factor authentication, have your authentication method ready. Close any Office applications that might be using OneDrive files, such as Word, Excel, or PowerPoint. Check that your Mac has enough free disk space to re-download any locally available files after the reset.
Steps to Reset OneDrive on Mac Without Losing Cloud Files
- Open OneDrive Preferences
Click the OneDrive cloud icon in the macOS menu bar at the top right of your screen. If the icon is not visible, open Finder and go to Applications, then double-click OneDrive. In the OneDrive window, click the gear icon and select Preferences. - Go to the Account Tab
In the Preferences window, click the Account tab. You will see your Microsoft 365 email address and the account status. - Unlink This Mac
Click the Unlink this Mac link. A confirmation dialog appears. Read the warning text carefully. It states that unlinking will stop syncing but will not delete your files from OneDrive.com. Click Unlink account to confirm. - Quit OneDrive Completely
After unlinking, right-click the OneDrive icon in the menu bar and select Quit. This ensures no background processes remain active. If you do not see the icon, open Activity Monitor, search for OneDrive, and force quit it. - Rename the Local OneDrive Folder (Optional but Recommended)
Open Finder. Go to your user folder, typically /Users/YourName/. Locate the folder named OneDrive – YourCompany. Rename it to OneDrive – YourCompany.old. This step prevents the new sync folder from conflicting with the old folder structure. Do not delete this folder until you confirm all files are synced correctly. - Launch OneDrive Again
Open OneDrive from the Applications folder. The setup wizard appears. Sign in with your Microsoft 365 work or school account. Enter your credentials and complete any two-factor authentication prompts. - Choose Your Sync Folder Location
During setup, you are asked where to place your OneDrive folder. By default, OneDrive proposes the same location as before. If you renamed the old folder in step 5, the new folder will be created fresh. If you did not rename it, OneDrive reuses the existing folder. For a clean reset, point to a new folder location or keep the default but ensure the old renamed folder is not in the way. - Select Which Folders to Sync
In the Choose Folders to Sync screen, uncheck all folders initially. Click Next. OneDrive creates the new sync folder structure but does not download any files. This gives you control over what comes back to your Mac. After the initial sync completes, open OneDrive Preferences, go to the Account tab, and click Choose folders. Select only the folders you need locally. OneDrive downloads those files. - Verify Cloud Files Are Intact
Open a web browser and go to the Microsoft 365 portal at office.com. Sign in with the same account. Open OneDrive from the app launcher. Confirm that all your files and folders are present. This verification ensures the reset did not affect the cloud storage.
If OneDrive Still Has Issues After the Reset
OneDrive Won’t Start After Unlinking
If OneDrive does not launch after you reinstall it, download the latest version from the Mac App Store or from the Microsoft OneDrive download page. Outdated versions can cause startup failures. Uninstall the current version using the OneDrive uninstaller in /Applications/OneDrive.app/Contents/Resources/Uninstall OneDrive.command, then install the fresh copy.
Sync Errors Persist After Reconnecting
Persistent sync errors usually indicate corrupted cache files. After unlinking, also clear the OneDrive cache manually. Quit OneDrive. Open Finder, press Command+Shift+G, and enter ~/Library/Application Support/OneDrive/. Delete everything inside this folder except the Settings folder. Restart OneDrive and sign in again. This forces the app to rebuild its cache from the cloud.
Files Show as Online-Only When You Need Them Offline
If files appear as online-only placeholders after the reset, right-click each file or folder in Finder and select Always keep on this device. OneDrive downloads the content. For bulk changes, select multiple items by holding Command while clicking, then right-click and choose the same option.
Reset Methods Compared: Unlink vs Reinstall vs Cache Clear
| Item | Unlink This Mac | Full Reinstall | Cache Clear Only |
|---|---|---|---|
| Description | Disconnects account, removes metadata, keeps app installed | Removes app and all local data, then installs fresh | Deletes sync cache files without disconnecting account |
| Cloud file safety | Files remain on server | Files remain on server | Files remain on server |
| Local file preservation | Kept if you rename folder | Deleted unless manually backed up | Kept |
| Time required | 10 minutes | 20 minutes | 5 minutes |
| Best for | Account or sync issues | Corrupted app or persistent errors | Slow sync or stuck files |
The Unlink method is the safest for preserving both cloud and local data. Use the full reinstall only when the app itself is broken. Cache clearing is a quick fix for minor sync problems but does not address account-level issues.
You now know how to reset OneDrive on a Mac without removing cloud files. The Unlink this Mac option is the key tool for this task. Next, review your Files On-Demand settings in OneDrive Preferences to control which files stay offline. An advanced tip: use the OneDrive web portal to check recent file activity before resetting, so you can confirm no one else is editing a file during the process.