OneDrive sync engines have specific failure states, and effective troubleshooting starts with diagnosing which state your sync is actually in rather than applying generic fixes. The OneDrive sync client displays an icon in the system tray (Windows) or menu bar (Mac) whose specific appearance indicates the current sync state — synced, syncing, waiting, paused, signed out, conflict, or error. Each state has different appropriate responses, and generic fixes that work for one state can be useless or counterproductive for others. Most “OneDrive not syncing” articles ignore this and present a flat list of fixes that fits some scenarios and produces no improvement in others. OneNote leans on the same Microsoft sync plumbing, so if it is your notebooks that are stuck, our guide to OneNote not syncing covers the notebook-specific fixes.
This matters because the realistic OneDrive sync failures are usually specific states with specific causes, not generic “sync broken” situations. Files stuck in waiting state because the queue is processing. Sync paused because the user accidentally clicked pause. Specific files failing while others sync fine. Account signed out without users noticing. Sync conflicts when files were modified in multiple places. Each requires different responses, and identifying the actual state takes seconds while applying random fixes takes minutes or hours.
This guide is structured around identifying the sync state first and then applying state-appropriate fixes. For broader context on the troubleshooting and fixes catalog, our complete guide to fixing errors covers the approach across many tool categories.
Step 1: Identify the Current Sync State
Before applying any fixes, click the OneDrive icon in your system tray (Windows) or menu bar (Mac) to see the sync status panel. The icon’s appearance and the panel’s contents indicate the specific state you are dealing with.
Solid blue cloud icon (synced): OneDrive shows everything is current. If files genuinely are not syncing despite this state, the problem may be that you are looking at the wrong OneDrive account, or specific files have been excluded from sync. Verify which account is configured and check whether the specific files you expect to sync are actually in OneDrive-monitored folders.
Blue cloud with circular arrows (syncing): OneDrive is actively transferring files. If you are seeing this state and files have not synced for a long time, the queue may be processing many files, large files may be transferring slowly, or specific files may be failing while OneDrive continues attempting them. The status panel shows what is currently being uploaded or downloaded with progress information.
Cloud with pause icon (paused): OneDrive sync has been paused, either by you (accidentally or deliberately), by Windows (when on metered connections or specific power states), or by OneDrive itself for various reasons. Right-click the icon and select Resume Syncing to restart sync.
Cloud with red X or warning (error): something is preventing sync. Click the icon and look for the specific error message in the status panel. Common errors include sign-in expired, storage full, file too large, file name invalid, account locked. Each has specific responses covered below.
Cloud with red exclamation point (conflict): files have been modified in conflicting ways and OneDrive cannot determine which version is correct. The status panel shows which files are in conflict. Resolution requires choosing which version to keep, covered in the conflict section below.
Greyed out cloud (signed out): OneDrive is not signed in. Click the icon and sign in with your Microsoft account credentials.
No icon at all: OneDrive may not be running. Check for the OneDrive process in Task Manager (Windows) or Activity Monitor (Mac). If it is not running, launch OneDrive from the Start menu or Applications folder. If it appears to be running but no icon is showing, try clicking the system tray overflow area (Windows) or check icon visibility settings (Mac).
The specific state identification determines which section below applies to your situation. Apply the targeted fixes for your specific state rather than the generic fixes that work for some states and waste time on others.
State: Paused or Stuck Sync
If OneDrive is paused or appears stuck in a long-running sync, the typical responses focus on resuming sync and resolving whatever caused the pause.
Resume sync explicitly. Right-click the OneDrive icon and select Resume Syncing if pause is the current state. The sync should restart immediately for most cases. If the option is greyed out or sync does not resume after clicking, additional troubleshooting is needed.
Check power and network settings that auto-pause OneDrive. OneDrive pauses sync automatically in several scenarios you may not have noticed: battery power mode (sometimes), metered network connections (when configured), low disk space (when configured), specific power-saving modes. OneDrive’s settings (right-click icon → Settings → Sync and backup) reveal which auto-pause behaviours are active and let you adjust them.
For seemingly stuck sync where the icon shows syncing but no progress is happening over many minutes, the sync may be processing a single large file or many small files. The status panel shows what is currently being processed. If the same file appears stuck for an extended period, that specific file may be the issue — covered in the specific-files section below.
Restart OneDrive if pause-resume cycle does not help. Right-click the OneDrive icon and select Quit OneDrive. Then launch OneDrive from the Start menu or Applications folder. The restart often resolves sync state issues that simpler interactions cannot.
If OneDrive consistently pauses or stops sync after restart, the issue may be deeper. Reset OneDrive (covered in the last section) is the more aggressive response that resolves most persistent state issues.
State: Specific Files Not Syncing While Others Work
When most files sync normally but specific files fail to sync, the issue is usually with those specific files rather than with the overall sync system.
File name issues are common causes of specific-file sync failures. OneDrive does not sync files with specific characters in filenames (^, *, <, >, ?, /, :, |, “), files starting with periods or spaces, files ending with periods or spaces, or specific reserved names (CON, PRN, AUX, NUL, COM1-COM9, LPT1-LPT9). The OneDrive sync error reporting usually identifies these issues; renaming the affected files to use only standard characters resolves the failures.
File size issues affect very large files. OneDrive’s individual file size limit (currently 250 GB) prevents larger files from syncing. For most users this is irrelevant, but specific use cases (large video projects, virtual machine images, large databases) may hit this limit. Files exceeding the limit cannot sync regardless of how long you wait or what fixes you apply.
Path length issues affect deeply-nested files. Windows has a maximum path length (260 characters in default configurations), and OneDrive cannot sync files with paths exceeding this. Files in deeply nested folders, particularly those with long filenames, may hit this limit. Shortening the path (renaming files or folders to shorter names, restructuring the folder hierarchy) resolves the issue.
Storage quota issues affect overall account capacity. If your OneDrive storage is full or nearly full, new files cannot sync until space is available. Check your storage status through the OneDrive web interface (onedrive.live.com) which shows current usage and what is consuming space. Either deleting unnecessary files or upgrading your storage plan resolves quota-related sync failures.
Permission issues prevent sync for specific files. If OneDrive cannot read a file due to file system permissions, it cannot sync the file. This typically affects files owned by other users on shared computers or files in protected system locations. Either changing file permissions or moving the file to a location OneDrive can access resolves these.
For specific files where none of the above applies, copying the file to a different location within OneDrive (forcing a re-sync) sometimes resolves stuck files. The fresh upload bypasses whatever state was preventing sync of the original.
State: Sync Failures After Windows Update or Sign-In Changes
One common scenario is OneDrive sync failing immediately after Windows updates, sign-in changes, or other system-level changes. The cause is usually authentication state confusion that targeted fixes resolve.
Sign out and sign back in. Right-click the OneDrive icon → Settings → Account tab → Unlink this PC. After unlinking, OneDrive prompts for sign-in. Sign back in with your Microsoft account credentials. This refreshes authentication state that may have become inconsistent during system changes.
Note that unlinking does not delete files from your computer or from OneDrive — it just stops the sync relationship. Files in the OneDrive folder remain accessible locally, and re-linking re-establishes sync without re-downloading everything.
For users who have multiple Microsoft accounts (personal Outlook.com plus work or school accounts), verify which account is currently linked. The OneDrive icon may be showing the wrong account, particularly if you have used multiple accounts on the same computer. Settings → Account tab shows the linked account; if it is not the one you expect, unlinking and signing in with the correct account resolves the mismatch.
Windows update issues sometimes affect OneDrive specifically. Microsoft occasionally releases OneDrive updates separate from Windows updates, and version mismatches can cause sync problems. Checking for OneDrive updates through the OneDrive settings (Account tab → About OneDrive shows version, with update prompts when needed) ensures you have the current version.
For users who specifically have work or school OneDrive accounts (Microsoft 365 Business), additional considerations apply. The IT department’s policies may affect sync behaviour, conditional access requirements may need re-authentication periodically, and device compliance requirements may need to be satisfied. Contact IT support for work-OneDrive-specific issues that user-level troubleshooting does not resolve. Our cloud storage for business comparison covers the related business category for context.
State: Conflict Detected
Sync conflicts occur when the same file has been modified in conflicting ways from multiple locations — typically when you edited the file on one device, made a change on another device before the first device finished syncing, or when changes happened during a period of offline editing.
OneDrive does not silently overwrite either version when conflicts are detected. Instead, both versions are preserved with one renamed to include the conflict marker — typically the device name and a copy indicator. The status panel shows which files are in conflict, and File Explorer shows the conflicted copies alongside the originals.
Resolving conflicts requires deciding which version to keep. Open both versions (original and the conflicted copy with the device-name suffix), compare the contents, and either keep one version while deleting the other, or merge changes into a single resulting file before deleting the conflicted copy.
For documents with substantial differences between versions, manual merging is sometimes the only appropriate response. Both files should be opened, the relevant changes from each identified, and a consolidated version created before resolving the conflict.
The conflict prevention strategy matters going forward. Ensuring devices fully sync before making new changes prevents many conflicts. For files that genuinely need to be edited from multiple devices, using cloud-native collaborative editing (Office on the web, Google Docs) avoids the conflict situation entirely because the editing happens collaboratively rather than as separate device-specific changes.
For users specifically dealing with frequent conflicts on shared work documents, the realistic recommendation is shifting to truly collaborative editing tools rather than fighting the sync model that produces conflicts. Our Dropbox sync troubleshooting guide covers the related category for users whose sync problems span multiple cloud storage services.
State: Known Folder Move Issues
OneDrive’s Known Folder Move feature redirects standard folders (Desktop, Documents, Pictures) to OneDrive automatically. When this feature has problems, the symptoms appear as documents disappearing from expected locations, desktop items missing, or unexpected sync activity.
Check Known Folder Move status. OneDrive Settings → Sync and backup → Manage backup shows which folders are currently being backed up through KFM. The folders listed there are being redirected to OneDrive automatically; folders not listed remain in their original locations.
If folders show as backed up but content seems missing, the files have been moved to OneDrive rather than deleted. They should still be accessible in the OneDrive folder under matching subfolder names. The “missing” desktop or documents are typically just relocated rather than lost.
If KFM has been disabled or unlinked unexpectedly, files may have been left in OneDrive while the local folder reverted to a non-redirected state. Re-enabling KFM in OneDrive settings restores the redirection. The files in OneDrive sync back to the appropriate local locations.
For users specifically experiencing KFM-related confusion (files appearing in unexpected places, duplicate locations of the same files, sync activity for files you did not expect to be syncing), reviewing the KFM settings clarifies what is actually being managed by OneDrive versus what is managed locally.
The KFM feature is genuinely useful for users who want their Desktop, Documents, and Pictures backed up automatically without remembering to save things in specific OneDrive locations. For users who prefer explicit control over what syncs versus what does not, disabling KFM and using OneDrive only for specifically-placed files produces more predictable behaviour.
State: Reset OneDrive Required
For persistent OneDrive sync problems that none of the targeted fixes above resolve, resetting OneDrive completely is the more aggressive response. This restarts OneDrive with fresh state while preserving your synced files.
On Windows, the reset command is: Win+R → enter the path to OneDrive.exe with /reset argument. The specific path varies by installation but typically resolves to something like %localappdata%MicrosoftOneDriveonedrive.exe /reset. The exact command for the current OneDrive version is documented at microsoft.com in OneDrive support articles.
The reset stops OneDrive completely and clears its operational state. When you restart OneDrive (Start menu → OneDrive), it performs a fresh initialization that resolves most persistent state issues.
Important: the reset does not delete your files. Files in the OneDrive folder on your computer and files in OneDrive cloud storage are both preserved. The reset only affects OneDrive’s internal sync state, configuration, and authentication tokens.
After reset, OneDrive may need to be signed in again, and the initial sync after reset takes longer than normal as OneDrive re-verifies the state of files between your computer and the cloud. The reset is typically the last resort before more aggressive responses like reinstallation.
For Mac users, the equivalent reset involves quitting OneDrive completely (right-click icon → Quit OneDrive), then deleting the OneDrive application data folder (~/Library/Containers/com.microsoft.OneDrive-mac and related folders), then relaunching OneDrive. The process is somewhat more manual than Windows but achieves the same fresh-state result.
If reset does not resolve persistent issues, complete uninstall and reinstall of OneDrive is the next escalation. This requires more setup work but produces certain-clean state. After reinstall, the initial setup is similar to first-time OneDrive configuration. Our cloud backup service comparison covers the related category for users who reach the point of considering alternative cloud storage options after repeated OneDrive issues.
The Practical Recommendation
For most users in 2026 experiencing OneDrive sync issues, the answer is to diagnose the specific sync state before applying fixes. Step 1: Identify the current state through the OneDrive icon and status panel (synced, syncing, paused, error, conflict, signed out, no icon). Step 2: Apply state-specific responses — Resume Syncing for paused, identify and fix specific failing files for partial sync issues, sign out and back in for authentication problems after system changes, manually resolve conflicts when they appear, address Known Folder Move state if folder redirection is involved, reset OneDrive completely for persistent issues that targeted fixes do not resolve. The wrong move is applying generic fixes without identifying the actual sync state, because fixes appropriate for one state are useless or counterproductive for others. Check the icon state first, apply the appropriate response for that specific state, and the troubleshooting becomes systematic rather than random. For users whose OneDrive sync issues recur frequently despite proper troubleshooting, the underlying causes (network reliability, file management patterns, account-level issues) may warrant deeper investigation or potentially evaluating alternative cloud storage. Our Microsoft Teams troubleshooting guide covers the related Microsoft 365 troubleshooting pattern that often applies to users in the same broader Microsoft ecosystem.
