OneDrive Not Syncing on a Mac? How to Fix It
OneDrive not syncing on your Mac? Find the right account and folder, check whether files are missing or stuck, then fix it safely.

If a OneDrive file is missing or out of date on your Mac, do not start by unlinking the account or moving folders around. First find the same file in OneDrive on the web. That tells you whether the problem is OneDrive on this Mac or whether the file is missing from the cloud as well.
This matters because “OneDrive is not syncing” can mean several different things. You might be signed into the wrong account, looking for a shared SharePoint folder rather than your personal OneDrive, waiting for an online-only file to download, or dealing with one file that is stuck while everything else is current.
First, check the file online
Pick one recent file that is missing, old or showing an error on the Mac and find the same location in OneDrive on the web.
If the correct version is online but not in Finder, that is useful news. Your cloud copy exists, so keep troubleshooting the Mac.
If the file is missing online too, unlinking OneDrive from the Mac is unlikely to bring it back. Check the online Recycle Bin, confirm which account and folder originally held it, and check whether another device has a newer copy that has not yet uploaded.
Do this before moving or deleting anything. A vague report that “the folder isn’t syncing” is much harder to solve than one known file with a known online result.
Make sure you are in the right Microsoft account
It is common to have a personal Microsoft account and a work account, sometimes using similar addresses. A file can appear to be missing when OneDrive is simply showing a different account from the one you expected.
Open the OneDrive cloud menu and check which account is connected. Then compare it with the account you used in the browser.
For a business, also check whether the file should be in your own OneDrive at all. Your personal working files normally live in OneDrive, while shared company files are usually stored in SharePoint. A folder used through a Teams channel is also backed by SharePoint. Our guide to OneDrive, SharePoint & Teams on a Mac explains how those locations fit together.
If a shared folder has disappeared
Do not assume your whole OneDrive has failed. If your own files are current but a shared business folder has disappeared, check that SharePoint library in a browser.
If other staff have lost the same library, the problem is unlikely to be one person’s Mac. Access, permissions or the library’s Microsoft 365 setup may need attention.
If the library is correct online and only one Mac is missing it, focus on the connection on that Mac rather than moving the business files somewhere else.
Check what OneDrive itself is telling you
Look at the OneDrive cloud icon in the Mac menu bar. If syncing is paused, resume it. If you have been signed out, sign back into the account you just confirmed online. If OneDrive is processing a large number of changes, give it time before doing anything more disruptive.
Restart the Mac as well. Then confirm normal websites load. Finder can still show yesterday’s OneDrive folders even when a network problem is stopping new uploads and downloads.
After the restart, return to the same test file. If it now matches the online copy, stop there.
Cloud storage & Mac storage are different
OneDrive can fail to upload new changes if the Microsoft account has run out of cloud space. Separately, the Mac needs enough local space for files that are being downloaded or kept offline.
Those limits are not interchangeable. Paying for more OneDrive storage does not make the Mac’s internal drive bigger, and freeing Mac storage does not increase the allowance in Microsoft 365.
If Mac storage is the real problem, our guide to why a Mac can be full despite having cloud space explains what is happening.
A cloud icon does not mean a file is missing
OneDrive on a Mac can show files in Finder without keeping their complete contents on the Mac. These online-only files download when you open them. That is normal Files On-Demand behaviour, not a failed sync.
If a file must be available without internet access, you can tell OneDrive to keep it on the Mac. If you want to release the local copy while keeping the file online, use OneDrive’s Free up space option rather than deleting the file.
Our guide to OneDrive Files On-Demand explains the status icons and the safe way to free local space.
Do not delete a OneDrive file just to save Mac storage
This is one of the easiest mistakes to make. OneDrive is a syncing service. Deleting a file from a synced OneDrive folder is intended to delete that file from OneDrive, not merely remove the local copy from the Mac.
If the goal is to reclaim Mac storage while keeping the online file, use Files On-Demand instead. Test it with a non-critical file first if you are not confident about what the status means.
If one file is holding things up
If most of OneDrive is current but one file keeps showing an error or waiting state, focus on that file rather than resetting the whole account.
Close the file if another app has it open and read the message OneDrive shows for it. If you decide to rename or move it, first confirm where the latest copy exists. Test one file before reorganising an entire folder.
If many unrelated files are failing at once, step back and look again at the account, network, storage and OneDrive status rather than treating each file as a separate fault.
If Desktop & Documents are not syncing
OneDrive’s Desktop and Documents folder backup is a separate feature from ordinary OneDrive syncing. Microsoft’s current Mac requirements say it needs the standalone OneDrive sync app rather than the Mac App Store version, and OneDrive needs Full Disk Access. A business administrator can also disable the feature for work or school accounts.
Before changing this setup, find out where the current Desktop and Documents files are actually stored. Microsoft notes that if folder backup is stopped, files that were already backed up remain in OneDrive rather than automatically returning to the original Mac folders.
That is why turning the feature off or moving folders around without checking can make it look as though files have vanished when they have actually stayed in a different OneDrive location.
Update OneDrive before unlinking it
If the problem is limited to this Mac, check for a current OneDrive update and restart the app. Then compare your test file with the browser again.
If it now matches, there is no reason to unlink the account. The safest repair is the one you no longer need to do.
Unlink & re-link only after you know the cloud copy is right
Microsoft says unlinking and re-linking OneDrive can solve some sync problems and does not itself delete the OneDrive data. On a Mac, the account can be unlinked from OneDrive’s Account settings and then signed in again.
Before you do that, make sure the recent files and changes that matter are visible online. If something important exists only on the Mac, deal with that first rather than assuming it will survive a repair untouched.
When you re-link, OneDrive can reuse the existing folder and rebuild the connection. Microsoft says it initially brings back placeholders rather than downloading every cloud file in full, but a large library can still take time to finish checking.
If re-linking also requires saved sign-in information to be repaired, use Microsoft’s current Mac instructions or get help. Do not delete a collection of Microsoft or Office entries from Keychain simply because an old troubleshooting guide says to remove credentials.
Why does OneDrive say it is synced when a file is missing?
It may be looking at a different problem from the one you are looking at. The missing file could belong to another Microsoft account, another OneDrive folder or a shared SharePoint library. It may also have been moved or deleted online.
Check the exact file online and confirm the account and location before treating OneDrive’s overall sync status as proof that the file should be in this Mac’s Finder folder.
Why is OneDrive syncing on another Mac but not this one?
If the correct files are online and another Mac is current, that is strong evidence that the cloud library itself is working. Focus on the affected Mac.
Check the connected account, OneDrive status, network, software version and available Mac storage before unlinking anything. Avoid changing the working Mac while you troubleshoot the one that is behind.
Why are my OneDrive files online but not downloaded to the Mac?
That is often normal Files On-Demand behaviour. An online-only file appears in Finder but downloads its contents when needed. If you need particular work offline, mark those files or folders to stay on the device rather than forcing the whole OneDrive library to download.
For a Mac with a smaller drive, that distinction is useful. It lets a large cloud library stay visible without using the same amount of local storage.
Why is a Teams or SharePoint folder missing from Finder?
Teams channel files are stored in SharePoint, not in your personal OneDrive. A shared SharePoint folder can therefore disappear from Finder while your own OneDrive continues syncing normally.
Check the library online first and whether other staff can access it. If the online library and permissions are correct, then troubleshoot its connection to this Mac. Do not move shared business files into personal OneDrive as a workaround.
OneDrive is useful, but it is not an independent backup
OneDrive keeps changes in step across devices. That is exactly what makes it useful, but it also means a deletion or unwanted change can sync elsewhere.
OneDrive has recovery features such as deleted-file recovery and version history, but they are not the same as keeping an independent backup. Our guide to cloud storage and backup explains the difference.
When to get help
Get help before unlinking accounts or moving whole folders if important files are missing both online and on the Mac, you cannot tell which account owns them, several people have lost a shared library, or recent work exists on only one device.
For a business, those symptoms can point to SharePoint permissions or the way Microsoft 365 has been organised rather than a fault with OneDrive on one Mac. Our Microsoft 365 setup guide explains the structure we recommend.
If you would like help finding the right files and getting OneDrive syncing safely again, contact Your Mac Tech.



