Fix OneDrive Sync Errors Before Files Stop Updating

When OneDrive stops syncing, a file saved on one computer may never reach the rest of your team. OneDrive sync errors often start with a simple cause, such as a paused app, an account sign-in issue, or full storage.

Work through the checks below in order, starting with the least disruptive fixes. Before unlinking an account or resetting the app, make sure important files are safely backed up.

Key Takeaways

• Check the internet connection, Microsoft 365 account, storage space, and sync status before changing settings.
• Resume syncing if it's paused, then inspect any files or folders OneDrive flags.
• Restart the app before trying unlinking or reset steps.
• Before making account changes, confirm that important files are available in the cloud or in a separate backup.
• Test the fix by checking the updated file in OneDrive on the web or from another device.

Step 1: Check Which Files and Users Are Affected

First, identify whether the problem affects one file, one computer, or several employees. Ask the person who reported it when the file last updated and where they saved it. Note any error message shown by OneDrive.

Next, open the OneDrive cloud icon in the taskbar on Windows or menu bar on Mac. Its activity panel shows sync status and recent activity. If OneDrive reports an error, capture the message before dismissing it. That detail can help distinguish an account issue from a file-specific problem.

Also confirm the file's actual storage location. A document opened inside Teams may live in OneDrive or SharePoint, and its permissions and sync behavior follow that location. OneDrive and SharePoint sync basics can help clarify where a shared file belongs.

Step 2: Check the Internet Connection and Account

A computer can appear connected while the connection is unstable or blocked from reaching Microsoft 365. Open a browser and load a few trusted sites. If other cloud services also fail, address the network connection before changing OneDrive settings.

If the issue affects only one office, compare access from another network, such as a mobile hotspot, when practical. This can help separate a local Wi-Fi, firewall, DNS, or internet provider issue from a problem with the OneDrive app. Avoid repeated sign-in attempts if the account keeps failing.

Then confirm that OneDrive is signed in to the intended work or school account. A personal Microsoft account and a business account can have different files and storage. If the employee recently changed their password or lost access to Microsoft 365, sign-in may need attention before syncing can resume.

When several employees can't access OneDrive, SharePoint, or other Microsoft 365 services, treat it as a broader service or tenant issue rather than a single-device error. A Microsoft 365 administrator can review service health and account access. For a wider interruption, follow Microsoft 365 sign-in and file access troubleshooting.

Step 3: Resume Syncing and Check Storage

A paused sync can look like a file problem because local changes remain on the computer without reaching the cloud.

Resume paused syncing

Select the OneDrive cloud icon and review its menu. If syncing is paused, choose Resume syncing . OneDrive can be paused for 2, 8, or 24 hours, so check the menu even if no one recalls stopping it.

Give the app time to process changes, especially if the computer has been offline or a large batch of files is waiting. Keep the device connected to the internet while it catches up.

Check available storage

Check the storage status for the account. When Microsoft storage is over its limit, OneDrive can't upload, edit, or sync new files. Freeing space or resolving the account's storage limit may restore syncing.

File size can also stop an upload. Microsoft lists a maximum file size of 250 GB for OneDrive upload, download, and sync. If an error names a particular large file, address that item rather than changing the whole sync setup.

Step 4: Inspect the Problem File or Folder

If other files sync normally, focus on the item OneDrive identifies. Confirm it's saved inside the correct OneDrive folder or synced SharePoint library, and that the employee has permission to access and edit it. A file saved in Downloads or another local folder won't sync just because OneDrive is running.

Check the file's location and access

If the file belongs to a department or project, make sure the team is using the right SharePoint library rather than relying on an individual employee's OneDrive. In Teams, channel files generally connect to SharePoint, while chat files may be tied to a user's OneDrive. The location affects ownership and access as well as sync.

For files moved during a migration, check whether the employee is still using an old shortcut or folder path. Common SharePoint and OneDrive sync problems after migration covers issues that can arise when a team changes its file storage.

Check the item itself

Read the full OneDrive error and follow its instructions. Make sure the file isn't still open in an application that may be holding a change, then save and close it. If OneDrive flags a name, path, or folder issue, correct the specific problem it identifies.

Don't delete a local copy to force a sync. First determine whether the cloud copy, local copy, or both contain the latest work. For a shared document, compare its contents and modification details before replacing anything.

Step 5: Restart the OneDrive App

Once the connection, account, storage, and file checks are complete, restart OneDrive. This is a low-risk way to clear an app that appears stuck without removing account connections.

On Windows, select the cloud icon, open OneDrive's menu, and choose Quit OneDrive . Then open OneDrive from the Start menu. On Mac, select the OneDrive cloud icon in the menu bar, quit the app, and reopen it from Applications.

After restarting, watch the activity panel for the affected file. If the app reports a sign-in prompt, paused sync, or named file error, address that message before moving to more disruptive steps.

Step 6: Unlink and Relink Only When Needed

Unlinking can help when OneDrive's connection to an account or computer is stuck. It temporarily disconnects local folders from OneDrive. Microsoft says unlinking doesn't erase data, and changes made while disconnected can sync after relinking. Still, protect important business files before proceeding.

Protect local work first

Confirm that critical files are present in the cloud or in a separate, reliable backup. Files On-Demand may show placeholders on a computer rather than locally stored copies. If a document is important to payroll, finance, or operations, make sure it's available through a known recovery method before changing the sync connection.

Syncing is not the same as backup. A local deletion or unwanted change can sync to the cloud, too. Version history may help restore an earlier file state, but it doesn't replace a tested recovery plan.

Relink the work account

On Windows, select the OneDrive cloud icon, then open Settings > Account > Unlink this PC . Sign in again and choose Use this folder when prompted, taking care to select the existing sync location.

On Mac, open OneDrive Preferences > Account > Unlink this Mac . Microsoft's Mac instructions also include removing the OneDrive cached credential in Keychain Access. Then sign in again and choose Use this folder during setup. Avoid deleting local folders as part of either process.

Step 7: Reset OneDrive After Simpler Fixes Fail

Resetting OneDrive is a later troubleshooting step, not the first one. Microsoft says a reset doesn't delete files or data, but it disconnects all sync connections, including personal and work or school accounts. You'll need to start OneDrive and complete setup again.

Reset on Windows

First, press Windows + R , enter wsreset.exe , and press Enter. If the sync issue continues, use Windows + R to run the appropriate reset command:

• %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
• If that path isn't available, try C:\Program Files\Microsoft OneDrive\onedrive.exe /reset
• If needed, try C:\Program Files (x86)\Microsoft OneDrive\onedrive.exe /reset

Afterward, open OneDrive from Start and complete setup.

Reset on Mac

Quit OneDrive, then open the OneDrive application package and go to Contents > Resources . Run ResetOneDriveApp.command , or use ResetOneDriveAppStandalone.command for the standalone app. Reopen OneDrive and select the previous sync location during setup.

If files are placeholders through Files On-Demand, they may remain placeholders after setup. Resetting can take time as OneDrive reconnects and checks the files, so avoid repeating the reset while it's processing.

Confirm That Files Are Updating

After any fix, test the same file that showed the problem. Save a small, recognizable change, then look at OneDrive's activity panel for upload activity and whether the change remains pending. Next, open the file through OneDrive on the web or another device and confirm that the change appears there.

Check the file's actual location before testing. A SharePoint document library and a user's OneDrive are separate storage locations, even if employees reach both through Teams or File Explorer. If the web copy doesn't reflect the change, don't overwrite it blindly. Compare the available versions and preserve the latest work before attempting another repair.

For business continuity, define where team records live and who owns them. Keep separate backups for files that the business can't afford to lose, and test recovery rather than relying on sync status alone.

Frequently Asked Questions

Does unlinking OneDrive delete files from my computer?

Microsoft says unlinking disconnects the local folder from the account without losing data. However, confirm that important work is backed up before unlinking, and don't delete local files during troubleshooting.

Why does a file in Teams fail to sync?

Teams displays files stored in OneDrive for Business or SharePoint. The storage location, permissions, and sync connection determine what happens, so check whether the file is in a chat or a channel and troubleshoot that underlying location.

How can I tell whether OneDrive is still syncing?

Open the OneDrive cloud icon's activity panel to see sync status and recent activity. Then confirm the change through OneDrive on the web or another device. A local edit alone doesn't prove that the cloud copy updated.

Is OneDrive sync a backup?

No. Sync keeps files aligned across locations, so unwanted changes or deletions can spread. Use a separate recovery plan for important company data, and test that plan.

Conclusion

OneDrive sync errors are easier to resolve when you start with connection, account, storage, and file checks before changing the sync setup. Restart the app next, and reserve unlinking or reset for persistent problems.

Most importantly, protect critical files before changing account connections. A successful sync gets work moving again, while a tested backup gives the business a way to recover when sync carries the wrong change.