OneDrive Not Syncing on Windows 11: Complete Troubleshooting Guide
OneDrive stuck on Sync pending or Processing changes in Windows 11? Follow safe, Microsoft-sourced fixes for red X errors, uploads, folder selection, reset, sign-in and reinstall.
Contents
- Start here: identify which OneDrive problem you have
- Before changing settings: perform a five-minute file safety check
- Step 1: check whether OneDrive is running and signed in
- What to do if OneDrive keeps asking you to sign in
- Step 2: resume paused syncing and check the network
- OneDrive reports “Looking for changes” but no files move
- Step 3: check Microsoft cloud storage and free disk space
- Check the cloud storage quota
- Check local disk space without deleting cloud data
- Step 4: fix OneDrive “Sync pending” on one file or folder
- Why your Word file can be stuck while photos sync normally
- Step 5: fix OneDrive stuck on “Processing changes”
- Outlook PST and OST files can complicate syncing
- Step 6: check invalid filenames, path length and blocked items
- Could too many files make OneDrive slow?
- Step 7: test whether only uploads or only downloads are failing
- Step 8: check Choose folders and Files On-Demand when a folder seems missing
- Cloud-only is not the same as failed synchronization
- Desktop or Documents are not where you expect
- Step 9: restart the OneDrive desktop sync app safely
- Step 10: unlink and re-link OneDrive only when simpler fixes fail
- Should you delete OneDrive credentials or setup files?
- Step 11: reset OneDrive using Microsoft's documented commands
- How to reset OneDrive on Windows 11
- Step 12: reinstall OneDrive when reset and re-link fail
- Fix OneDrive for work or school and SharePoint library problems
- The browser-access test for a work or school account
- When SharePoint files appear online but not in File Explorer
- Why OneDrive behaves differently on two Windows 11 computers
- A missing file versus an older version of the same file
- What to do if OneDrive sync breaks after a Windows update
- Example: a freelancer's project folder will not upload
- Example: a student sees “Sync pending” on thousands of files
- Example: a company user loses access to one SharePoint library
- Troubleshooting mistakes that can cost you files
- Final verification: prove that OneDrive is syncing correctly
- When it is time to contact Microsoft or your IT administrator
- The safest order to fix OneDrive not syncing
- Official Microsoft sources and further reading

OneDrive not syncing on Windows 11 can mean several different problems. A file may stay at “Sync pending”, the cloud icon may display a red X, a folder may be missing from File Explorer, or the app may stay on “Processing changes” while your files remain available on the web. In other cases, your desktop and phone disagree about the newest document. The right fix depends on which of these situations you have—and on whether OneDrive is signed in with a personal Microsoft account or a work or school account.
Quick fix: Open the OneDrive cloud icon near the Windows 11 clock, read the specific error, and check whether the same file appears at OneDrive on the web. Make sure syncing is not paused, verify your Microsoft storage allowance and internet connection, then correct the individual blocked file if one is named. Only if the problem persists, restart OneDrive, unlink and re-link the account, or perform Microsoft’s documented reset. These later steps rebuild synchronization and should follow a verified backup of important unsynced work.
Protect your files before troubleshooting: Do not delete the OneDrive folder, use a registry cleaner, rename random system files, or uninstall OneDrive in a rush. If a document was edited locally but never uploaded, confirm that you have a separate copy outside the synced folder. A cloud synchronization service is not a substitute for an independent backup.
Reviewed October 16, 2026. These steps apply to the current OneDrive desktop sync client on Windows 11. Microsoft may change menu labels, eligibility, limits, and service behavior; organizational IT policy can override settings.
Start here: identify which OneDrive problem you have
Many guides offer the same reset command for every OneDrive problem. That is rarely the most efficient starting point. First identify the symptom and select the least disruptive action.
| Red X on a file or cloud icon | An item or account has a sync error | Select cloud icon and read the error details |
|---|---|---|
| Gray cloud icon with a line | Not signed in or setup incomplete | Launch OneDrive and finish sign-in |
| Cloud icon with pause symbol | Sync deliberately or automatically paused | Choose Resume syncing; inspect metered network/battery settings |
| “Processing changes” for a long time | Large queue, open/temporary file, recent update, sign-in | Check pending files and allow a busy initial sync to finish |
| “Sync pending” on one folder | Hidden or temporary file, empty folder, blocked item | Show hidden items and examine that folder |
| Files sync to web but not this PC | Folder selection, online-only files, local app issue | Compare web library and Choose folders settings |
| New files cannot upload | Full Microsoft storage, network, blocked filenames, account | Check quota and the file-specific error |
| Only a company SharePoint library fails | Account permission, library policy, sync restrictions | Check web access and contact IT if managed |
The meanings of the sync icons come from Microsoft’s official OneDrive icon guide. Icons are useful signals, not diagnoses by themselves: the error text inside the activity panel is the decisive next step.
Before changing settings: perform a five-minute file safety check
Step 1 — Check the cloud copy. Sign in to OneDrive for personal accounts or your organization’s Microsoft 365 OneDrive site. Find two or three important files and check the latest modified dates. Do not assume a file was uploaded just because a green check appears somewhere in File Explorer.
Step 2 — Find any unsynced local changes. Open the OneDrive cloud icon and read the recent activity and error list. If the app mentions a specific document, open that document from the PC and save a copy to a clearly named folder outside OneDrive, such as a folder on an external SSD. If a file is cloud-only, download its full contents before relying on an offline copy.
Step 3 — Identify the account. A white cloud typically refers to personal OneDrive, while a blue cloud typically refers to work or school OneDrive. A computer can show both. Verify the email shown under OneDrive Settings → Account; a missing file in the wrong account is not necessarily a failed sync.
Step 4 — Know what synchronization can delete. Deleting a file from a folder that is actively synced can delete it from the cloud and your other devices. If your purpose is only to make a file available offline, use Always keep on this device. If your purpose is only to reclaim local disk space, use Free up space where available—not Delete. Microsoft’s Files On-Demand guide explains the difference.
Step 5 — Record any exact error. Note the filename, error code, Microsoft account type, and whether the problem is uploading, downloading, or both. This information is more useful than blindly reinstalling the app.
Step 1: check whether OneDrive is running and signed in
Look at the Windows 11 notification area beside the clock; select the upward arrow to reveal hidden icons. Find the OneDrive cloud. If there is no icon, open Start, search for OneDrive, and launch the desktop app. If Windows offers a sign-in or setup screen, enter the same account that owns the online files.
If you see two OneDrive clouds, open each one before troubleshooting. The app connected to an employer may be syncing a SharePoint library while a personal OneDrive account works perfectly. The distinction can save you from resetting the wrong account. Microsoft documents these signs in OneDrive isn’t running.
What to do if OneDrive keeps asking you to sign in
- Open OneDrive → Settings → Account and verify the correct Microsoft account is listed.
- Try signing in to the same account in a browser. A successful browser sign-in helps distinguish an account-access problem from a desktop-client problem.
- If your password was recently changed, complete the new sign-in and any MFA request in the official Microsoft dialog.
- For a work account, confirm the user still has an active license and permission to the SharePoint or OneDrive library; only an authorized administrator can resolve certain restrictions.
- Restart the desktop OneDrive app and check whether its sign-in prompt is now resolved.
Do not enter a Microsoft password into a pop-up you cannot identify. If a message or link seems suspicious, close it and access the account through Microsoft’s official site.
Step 2: resume paused syncing and check the network
OneDrive can pause on a metered network or when Windows enters battery saver mode. Users sometimes see the paused cloud symbol and conclude that the client is broken. Microsoft confirms that OneDrive can pause automatically under those conditions. Pause and resume OneDrive sync — Microsoft Support.
- Select the OneDrive cloud icon and look for Paused, a pause symbol, or a Resume syncing action.
- Select Resume syncing if it appears.
- If it pauses again, open Windows Settings → Network & internet → your active Wi-Fi or Ethernet connection. Check whether the connection is set as metered; consider temporarily disabling the metered setting if you have adequate data allowance and permission.
- Check Windows Settings → System → Power & battery for an active energy-saving mode. Plugging a laptop into power may help with a long upload.
- Open a browser and test a couple of unrelated websites plus your actual OneDrive web account. A working browser page does not prove every Microsoft endpoint is reachable, but it rules out a total internet outage.
- Retry one small, non-sensitive text document after the app resumes. Large video uploads are a poor initial test.
For managed computers, VPNs, security gateways, authentication proxies, and firewall rules may be controlled by IT. Do not disable antivirus or endpoint protection merely to make OneDrive connect. Ask your administrator to review the network path and the OneDrive application’s error details.
OneDrive reports “Looking for changes” but no files move
A new sign-in, a Windows update, or a large set of changed files can cause a period of scanning. Check the activity panel and the network rather than repeatedly resetting the client. If the queue is visibly progressing, let it work. If nothing changes after a reasonable observation period and a small test file is also stuck, continue with the file, capacity, and repair steps below.
Step 3: check Microsoft cloud storage and free disk space
Cloud quota and PC disk capacity are different limits. A full Microsoft account can prevent new uploads or synchronization even when Windows has hundreds of gigabytes free. Conversely, files marked Always keep on this device may need local storage even when OneDrive has plenty of cloud capacity. Microsoft’s Fix OneDrive sync problems specifically warns that exceeding Microsoft storage can block new uploads, edits, and syncing.
Check the cloud storage quota
- For a personal account, check Microsoft’s storage dashboard while signed in with the owner account; for a business account, check the quota displayed by OneDrive on the web or ask an administrator.
- Look for warnings that the account has exceeded its permitted cloud storage.
- If a Microsoft 365 subscription has expired, check the plan status at Microsoft account services. An expired plan may leave you with less storage than before.
- If you need to free cloud space, first download and independently verify important files. Review cloud recycle-bin contents and applicable retention rules before permanently removing data.
- After restoring enough cloud capacity, restart or resume OneDrive and test a new upload.
An account can be over quota even if a particular folder is tiny. Check the storage for the signed-in account, not just the disk usage of the local OneDrive directory.
Check local disk space without deleting cloud data
Open Windows Settings → System → Storage and check the drive holding your OneDrive folder. If it is nearly full, move unrelated temporary downloads, empty Windows’ temporary items deliberately, or use Files On-Demand for cloud-backed files you do not need offline. For files within a OneDrive folder, Free up space is generally safer than deleting them if you want to keep the cloud copy. Keep a backup of anything irreplaceable.
Step 4: fix OneDrive “Sync pending” on one file or folder
A folder can show Sync pending even when you see no obvious problem file. Microsoft notes that hidden items and temporary files may cause this. Start by opening the folder in File Explorer, selecting View → Show → Hidden items, and looking for a relevant hidden or temporary file. See OneDrive is stuck on “Sync pending”.
If a particular document is blocked, close applications that may be using it. Open and save a separate copy of the latest locally edited version if necessary; do not delete temporary files that might contain unsaved work. A temporary file produced by another program may still be needed by that program.
For an apparently empty folder showing a pending status, Microsoft suggests creating a new folder, copying the original contents into it, and removing the problematic original folder. Apply that workaround only after checking for hidden data and verifying backups, and prefer it only when Microsoft’s described empty-folder condition matches your situation. An empty folder waiting on sync does not justify deleting a parent directory containing other documents.
Why your Word file can be stuck while photos sync normally
The file may still be open, it may have a name or path that OneDrive rejects, or it may be part of an Office collaboration conflict. Close Word or Excel, wait for it to finish saving, and review OneDrive activity. Make a safety copy if multiple people edited it. If another participant modified the cloud version, compare both versions before choosing which one to retain.
Step 5: fix OneDrive stuck on “Processing changes”
Microsoft identifies several legitimate reasons for a long Processing changes status: an open file, many newly added files, an unusually large item, a recent computer update, or an incomplete sign-in. Microsoft’s dedicated guidance recommends checking those causes first.
- Select the OneDrive icon and inspect the most recent files in its activity list.
- Close any application holding a problem file open, particularly a large archive, database, video, or Outlook data file.
- If thousands of files were just added or updated, check whether the number remaining is decreasing rather than interpreting a long scan as a permanent failure.
- Confirm the PC is connected to a reasonably stable network; an upload-limited connection can make changes appear stalled.
- If the file list identifies a single blocked item, move a copy into a safe non-synced backup folder, then correct the underlying file-name or application problem.
- When the client does not progress despite these checks, use the later unlink-and-relink or reset procedures—but not before preserving local unsynced edits.
Outlook PST and OST files can complicate syncing
Large, frequently changing Outlook data files can keep the synchronization client busy. Microsoft notes that PST files are supported but synced less frequently than many other formats, and advises care with Outlook’s active mail data. Do not move an Outlook profile’s data file while Outlook is running or delete it to clear a cloud icon. If an Outlook PST is inside a synced OneDrive directory and causing repeated trouble, use Microsoft and Outlook’s documented procedures to relocate it to a safe, supported local location, with a backup first. OST files are generally rebuildable cache files but are still not a reason to experiment on a working Outlook profile.
Step 6: check invalid filenames, path length and blocked items
OneDrive has rules for names and paths. Windows 11 may allow a particular document to exist locally while OneDrive cannot synchronize its path correctly. Microsoft lists characters such as quotation marks, asterisks, colons, angle brackets, question marks, forward and back slashes, and vertical bars as invalid in synced filenames. Leading or trailing spaces and certain reserved names also matter. See OneDrive and SharePoint restrictions.
| Invalid name | ", *, :, <, >, ?, /, \, the vertical-bar character or trailing spaces | Rename a copy without the prohibited characters |
|---|---|---|
| Reserved name | Examples include CON, PRN, AUX, NUL, desktop.ini, certain ~$ names | Use a normal descriptive name; don’t rename system files blindly |
| Excessive nesting | Deep folder structure or long filenames | Shorten names or reduce nesting cautiously |
| Temporary or active application file | .TMP, working locks, an application still open | Close program; preserve unsaved work; let app clean up its own temporary files |
| Large batch of files | Very many files or newly migrated folders | Allow first sync; split transfers where practical and supported |
| Restricted library or item | Work/school policies, information protection or permission | Confirm web access and request administrator support |
Microsoft’s path-length documentation specifies a 400-character decoded cloud path and a 520-character overall sync-path combination in its current guidance. Other Windows and Office limits can differ. For a blocked item, try moving a verified copy closer to the root of the OneDrive folder with a short filename, and test that copy. Be careful: moving the original while the client is syncing can trigger a cloud move that affects other devices.
Could too many files make OneDrive slow?
Yes. Even under published supported limits, enormous numbers of items increase scanning, metadata work, and recovery time. Microsoft says rollout for syncing up to one million items started in April 2026, but rollout and performance are not identical to a guarantee that every machine will handle that many items well. Do not assume a specific account or client has the latest limit. A laptop with many tiny files can be slower to reconcile than one holding a few large documents. For libraries with huge item counts, follow current organization guidance and Microsoft’s restrictions page.
Step 7: test whether only uploads or only downloads are failing
Make a small test file named onedrive-sync-test.txt, avoiding private information. Save a copy in your local OneDrive folder, wait for the status to update, and check the same folder in the OneDrive web interface. Then create another small test file on the web and see whether it appears in Windows File Explorer.
| PC file appears on web, but web file does not appear on PC | Upload path works; check download, folder selection and local availability | Inspect Choose folders, File Explorer location and app status |
|---|---|---|
| Web file appears on PC, but PC file does not appear on web | Download path works; uploading is blocked or file location is wrong | Inspect storage, specific upload error and whether test is truly inside OneDrive |
| Neither direction works | Client, sign-in, account or connection may be at fault | Check pause/authentication, then advanced repair |
| Both work | Global sync is functioning | Focus on the original document or its parent folder |
Delete only disposable test files after confirming the experiment. Don’t use an irreplaceable document for this test. If you are working inside a company SharePoint library, test in a personal permitted folder instead of adding files to a shared records repository.
Step 8: check Choose folders and Files On-Demand when a folder seems missing
A folder missing from File Explorer might be excluded from this PC, not missing from OneDrive. Open the OneDrive cloud icon → Settings → Account → Choose folders and verify the relevant cloud folder is selected. The cloud browser continues to show all your folders even when a computer is configured to sync a smaller subset. Microsoft explains this in Choose which OneDrive folders to sync.
Be aware that changing folder selection can remove that folder’s local representation while its contents remain in the cloud. It is not a troubleshooting step to use blindly if you have unsynced local edits. Confirm the newest versions are online first.
Cloud-only is not the same as failed synchronization
With Files On-Demand, an online-only file can appear in File Explorer without occupying its full size locally. It downloads when you open it online. Always keep on this device requests an offline copy; Free up space reverts a downloaded file to a cloud-only state. A cloud icon beside the filename alone doesn’t prove a failure to sync. Refer to Microsoft’s file-status icon meanings before changing settings.
Desktop or Documents are not where you expect
If your Desktop, Documents, or Pictures location appears inside OneDrive, known-folder backup is separate from routine file synchronization. Turning that backup on or off can change where Windows stores familiar folders. We already have a dedicated Horus Valley guide to stopping unwanted OneDrive syncing without losing files. Use that article if the complaint is “OneDrive keeps uploading everything,” rather than “OneDrive won’t upload new files.” This distinction helps avoid risky changes to folder redirection while troubleshooting a simple paused upload.
Step 9: restart the OneDrive desktop sync app safely
If the account, quota, network and file-specific checks look normal, a straightforward restart is lower-risk than resetting all sync settings.
- Select the OneDrive cloud icon.
- Open Help & Settings or the gear menu and choose Quit OneDrive if available.
- Open Start, type OneDrive, and launch the desktop app again.
- Let the client sign in and inspect its activity panel.
- Retry your small test file and compare results on the web.
Quitting temporarily stops synchronization; it does not delete your online account. Menu wording can vary by build. Rebooting Windows can also clear stale processes, but save open work first.
Step 10: unlink and re-link OneDrive only when simpler fixes fail
Microsoft recommends unlinking and re-linking a PC for some persistent sync problems. The process disconnects local folders from the cloud temporarily and then reconnects them. It does not intentionally delete your data, but you still need to safeguard work that has not uploaded and verify any cloud-only files you need offline. Official procedure: Unlink and re-link OneDrive.
- Confirm the correct account and make a separate copy of irreplaceable unsynced files.
- Select the cloud icon → Help & Settings → Settings.
- Open Account and select Unlink this PC; confirm the prompt.
- Open OneDrive from the Start menu if the sign-in window does not appear automatically.
- Sign in with the same account. When the setup screen identifies the existing OneDrive folder, choose the existing location only if it is genuinely the intended folder and you have checked its contents.
- Complete setup and review Choose folders. Custom folder-selection choices may need to be restored.
- Allow OneDrive to scan and reconcile; it may recreate cloud-only placeholders before downloading actual file contents.
- Test a new local upload and a new cloud-side download, then verify your original affected item.
Do not create multiple folders named OneDrive, OneDrive (1), and OneDrive (2) without understanding why. Duplicated local folders can make it difficult to identify where unsynced edits live. A separate backup with clear timestamps is safer than guessing.
Should you delete OneDrive credentials or setup files?
Microsoft’s unlink-and-relink instructions include an optional step involving a specific sign-in settings file when clearing credentials is necessary. This is not a general recommendation to wipe OneDrive’s Settings folder, credential stores or registry keys. Most users should first try straightforward unlinking and signing back in. On a managed computer, let IT handle persistent sign-in-token problems.
Step 11: reset OneDrive using Microsoft’s documented commands
Use a reset when the client continues malfunctioning after other causes have been ruled out. According to Microsoft’s Reset OneDrive instructions, resetting rebuilds settings and synchronization connections, then performs a full sync. Microsoft says resetting does not delete files or data; nonetheless, protect local changes that have not yet reached the cloud.
How to reset OneDrive on Windows 11
- Save your work, close any active edits, and copy critical unsynced documents to a folder outside OneDrive.
- Press Windows + R to open Run.
- Microsoft currently suggests running
wsreset.exefirst, which clears the Microsoft Store cache; a Command Prompt window may open briefly, followed by the Store. Close the Store if it opens. - Press Windows + R again, paste
%localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. - If Windows reports that it cannot find that file, try
C:\Program Files\Microsoft OneDrive\onedrive.exe /reset. - If necessary, try the alternate install path
C:\Program Files (x86)\Microsoft OneDrive\onedrive.exe /reset. - Search OneDrive from Start and open the desktop sync app manually.
- Check the account and folder configuration, then wait for reindexing and resynchronization.
- Repeat the two-way small-file test and verify the original documents on the web and locally.
Copy the command exactly: the spaces, backslashes, and /reset switch matter. The location may differ by installation. If none of those OneDrive paths exists, you might not have the desktop sync app installed. Microsoft distinguishes the OneDrive desktop sync client from a Microsoft Store viewing app; installing only a viewer won’t restore folder synchronization.
Important: A reset is not a “recover deleted documents” function. It cannot reconstruct a file that was never saved, undo an intentionally synchronized deletion, override a full cloud quota, or repair a broken company account permission. Use the Windows and OneDrive recycle bins, file version history, or an independent backup for actual data recovery.
Step 12: reinstall OneDrive when reset and re-link fail
Reinstallation is a later remedy, especially if the client cannot start, its executable is missing, or the setup is corrupted. Microsoft’s Reinstall OneDrive page explains that the sync client can be reinstalled and your online files should remain in the Microsoft account. However, any local edits that have not synced must be preserved separately, and files shown as online-only may not be present on disk.
- Confirm important files exist in the cloud or in a verified independent backup; capture unsynced local modifications separately.
- Open Windows Settings → Apps → Installed apps and locate Microsoft OneDrive if present.
- Uninstall the desktop sync app according to Windows’ available options.
- Download the current app from Microsoft’s official OneDrive website, not a third-party software mirror.
- Run the installer, open the desktop app and sign into the correct account.
- Review folder location and folder-backup prompts rather than assuming the previous choices will be restored.
- Give OneDrive time to reconcile, then test uploads and downloads and check for conflicts.
Uninstalling the app is not the same as deleting the OneDrive cloud account. Still, it does not automatically convert all cloud-only placeholders to downloaded files, and it doesn’t resolve storage or permission problems on its own.
Fix OneDrive for work or school and SharePoint library problems
OneDrive for a company or school may use the same desktop sync client but operate under a different security, licensing and permissions model. Microsoft 365 administrators can restrict storage, device sign-in, external sync, folder backup, proxy access or permissions. SharePoint document libraries add their own site and library settings.
The browser-access test for a work or school account
- Sign in to your organization’s Microsoft 365 account and open OneDrive or the affected SharePoint library in the browser.
- Confirm whether you can see the problem file and have the required edit permissions.
- If access is denied or the library is missing in the browser, resetting your Windows OneDrive client is unlikely to fix the underlying entitlement.
- If the browser works but the desktop sync client fails, capture the exact error message and the affected library URL for IT.
- If the entire organization reports the same issue, have an authorized administrator check Microsoft 365 service health and relevant policy or licensing changes.
Microsoft also documents a Repair command for the older OneDrive for Business client named groove.exe; that document explicitly states it is not the normal modern onedrive.exe workflow. Do not follow outdated screenshots suggesting an unavailable Repair menu for today’s Windows 11 client. See Microsoft’s legacy Repair explanation.
When SharePoint files appear online but not in File Explorer
Check whether you are looking at the correct library, whether it is being synced as a library or attached through an Add shortcut to OneDrive approach, and whether your account still has permission. Avoid enabling overlapping configurations for the same content without following Microsoft’s current guidance. A library owner may restrict offline availability, and IT may need to resolve the setting. For a shared team library, coordinate before unlinking or altering setup to avoid confusion over local working copies.
Why OneDrive behaves differently on two Windows 11 computers
Each PC can select a different set of folders to sync, and Files On-Demand settings can differ. A work laptop may also have security policies or a slow VPN that a personal laptop does not. If a file appears on the phone and OneDrive website but not the PC, examine the PC’s account, folder selection and download status, not only the cloud server.
A file could also be a shortcut, a shared document owned by someone else, or a web-only item that the current device has not synced. Check the full web path and the PC’s intended folder before creating duplicate copies of the file.
A missing file versus an older version of the same file
If a file exists but is outdated on one device, review its last modified time and look for version history in the appropriate Microsoft interface. Compare contents instead of trusting names alone. If another computer has a newer unsynced version, export a separate copy before forcing a new sync, because merging or replacing files without comparing versions can overwrite work.
What to do if OneDrive sync breaks after a Windows update
After a major Windows or Microsoft 365 update, a newly restarted client may scan a large set of folders. First give it time to enumerate changes while watching for progress. Reopen the app, check for current OneDrive updates from Microsoft, and verify that Windows date, time, and account authentication are correct. If a specific error remains after the scan, work through the staged steps instead of immediately performing a system restore or editing the registry.
If you suspect an organization-wide policy change, record the affected Windows build, OneDrive client version, exact error text, and whether the same account works on the web. Those details help support distinguish a local client regression from a company policy issue.
Example: a freelancer’s project folder will not upload
A freelancer edits a client spreadsheet in OneDrive\Projects\Client-A. The folder shows a red X, but several other folders are green. A quick comparison on OneDrive.com shows the spreadsheet’s previous version, not today’s edits. The safe sequence is: save a copy of today’s local spreadsheet outside the synced directory, inspect OneDrive’s error for the exact file, check name/path and storage, close Excel, then retry a separate small copy. If the sync client still fails for every file, move to restart or unlink-and-relink. The critical business outcome is protecting the only newest version before doing anything else.
Example: a student sees “Sync pending” on thousands of files
A student moves a large course archive into OneDrive, then immediately assumes Windows is frozen because “Processing changes” persists. In this case, the first checks are item count, file sizes, bandwidth, activity movement, available cloud storage and individual blocked filenames. If progress continues, let it finish. Resetting the application mid-transfer may force a full rescan and add time without fixing a real problem. If one specific folder remains pending after the rest succeeds, focus on that folder and temporary files.
Example: a company user loses access to one SharePoint library
A marketing employee can sync their own OneDrive but gets an access error on one team’s library after a project reorganization. The browser reports insufficient permissions for the same library. This is an access problem, not evidence that Windows 11’s sync engine is corrupted. IT or the site owner should verify permissions and any policy changes. Reinstalling OneDrive cannot grant the missing library permission.
Troubleshooting mistakes that can cost you files
- Deleting the local OneDrive directory before verifying the web copies and the status of unsynced local edits.
- Confusing “Free up space” with Delete. One removes downloaded contents while preserving the cloud copy; the other can synchronize deletion.
- Moving a live Outlook data file without closing Outlook and verifying the file location.
- Running random
regedit, PowerShell or “OneDrive repair” commands copied from forums before reading the actual error message. - Emptying both recycle bins while investigating a missing-file incident.
- Unlinking the wrong account on a PC with both white personal and blue work/school clouds.
- Turning off managed security controls to test an unverified network theory.
- Assuming every Files On-Demand placeholder is an offline backup.
- Renaming hundreds of files simultaneously without a backup and a clear list of the files OneDrive actually rejected.
- Expecting a client reset to cure an expired subscription, full quota or revoked SharePoint permission.
Final verification: prove that OneDrive is syncing correctly
You have not truly fixed synchronization until you can show that changes travel in both directions.
- Create one small disposable text file in the intended local OneDrive folder.
- Wait for the sync indicator to finish and open OneDrive in a private or refreshed browser session.
- Confirm the local test file exists on the web and opens with the same contents.
- Create a separate small file on the web in a folder that is selected for syncing on this PC.
- Wait and confirm the web-created file appears and opens in File Explorer.
- Recheck the originally affected file: compare modified dates and, more importantly, the actual document contents.
- If other computers or users edit the document, compare their versions before discarding local copies.
- Delete the disposable test documents once they have served their purpose; keep your independent backup until real work is confirmed safe.
If a single document still refuses to upload even though both tests succeed, it is likely a file-specific issue, not a globally broken sync client. Return to that file’s naming, open-file lock, path, sharing and version-conflict details.
When it is time to contact Microsoft or your IT administrator
Contact support when the official reset and reinstall steps have failed after quota, account, network and file-specific causes were excluded; when OneDrive reports a repeated unknown error; or when business permissions or policy restrictions are involved. Provide the exact error message, account type, OneDrive client version, Windows 11 build, affected folder, and whether browser access works. Never send support your password, recovery codes, confidential file contents, or unredacted personal identifiers unnecessarily.
For a work or school account, use your company’s approved support route. For a personal account, start with Microsoft OneDrive help. If actual files have disappeared, describe the deletion or version-history situation explicitly; it requires a different recovery strategy from a simple connection failure.
The safest order to fix OneDrive not syncing
First, inspect the exact error and protect unsynced work. Next, check the cloud account, pause status, network, quota, filenames and folder selection. If synchronization is still stuck, restart the app. Re-linking, resetting and reinstalling are later steps, not the first things to do. The most useful test is a small-file upload and download that you verify in both places. If you need to stop unwanted OneDrive backup rather than repair broken syncing, use our separate guide to stopping OneDrive syncing everything safely.
Official Microsoft sources and further reading
- Fix OneDrive sync problems — Microsoft Support
- What do the OneDrive icons mean? — Microsoft Support
- OneDrive stuck on Processing changes — Microsoft Support
- OneDrive stuck on Sync pending — Microsoft Support
- Pause and resume OneDrive — Microsoft Support
- Choose which folders to sync — Microsoft Support
- OneDrive filename and sync limitations — Microsoft Support
- OneDrive file path length limits — Microsoft Support
- Unlink and re-link OneDrive — Microsoft Support
- Reset OneDrive on Windows — Microsoft Support
- Reinstall OneDrive — Microsoft Support
- Files On-Demand for Windows — Microsoft Support
