Source review: September 29, 2026. Tenant validation pending.
Page tools and document details
Compare one file with its cloud copy
Unexpected mass deletion or encryption needs incident response. Pause the affected client's sync while its owner investigates ongoing damage.
Scope and access
This guide covers the current OneDrive sync app, OneDrive.exe, on Windows with a work or school account. It does not cover the old groove.exe client, macOS or mobile repair. Use your normal account and approved network; these checks do not need a tenant-wide administrator role.
Record the Windows and OneDrive versions and all configured sync accounts before a reset. An administrator may need to resolve an account, quota, access or device-policy restriction. A stuck client alone does not establish a need for a different license.
Match the displayed state to the right check
| Observation | Next check |
|---|---|
| Sync is paused | Resume from the OneDrive activity panel after checking why it paused. Confirm progress on the same file. |
| OneDrive is not running or signed in | Open OneDrive from Start and use the intended account. Escalate a device-policy block; do not edit the registry to bypass it. |
| The browser also denies access | Use the permissions guide. Resetting the sync app cannot grant access. |
| A particular filename, path, lock or quota is named | Correct that specific condition with the owner. Name and path limits depend on the app and location; use Microsoft's current restrictions below. |
| The cloud copy is correct, but one device stays pending | Follow the bounded client steps below after preserving local work. |
| The cloud file is missing or has the wrong contents | Use file recovery. A sync reset is not a content restore. |
Distinguish a slow scan from a blocked file
Take two observations several minutes apart: the same activity-panel error, remaining file count and whether a small agreed file reaches the browser. A falling count indicates progress. An unchanged error naming one item points to that item.
Check the exact blocked name and full path against Microsoft’s restrictions. Save a readable copy before shortening a path or resolving a conflict. Check both local free space and the cloud quota. Do not delete files from a synced folder to “free the client” because that deletion can propagate.
Microsoft still recommends no more than 300,000 items for best performance. The newer one-million-item Windows capability is a public preview with specific hardware and Insider requirements, not a general production limit or a reason to enroll a business device during repair. Include synced SharePoint libraries and shortcuts in the scope review.
Try the smallest client correction
- Save and close the affected document in its editing app. Confirm local disk space, network access and the account's reported storage status.
- For paused sync, choose Resume syncing. Otherwise try one pause/resume cycle from the OneDrive panel and observe the same item. Growing progress is different from an unchanged error.
- If one item is named, preserve its content before an owner-approved rename, path correction or conflict resolution. Do not delete temporary or unfamiliar files merely to clear a pending icon.
- For a persistent client-only problem, record the app version and use the organization's approved OneDrive update or repair route. If many people are affected, have the helpdesk check service health before resetting clients.
When a reset is appropriate
After these checks, an authorized operator can follow Microsoft's Windows reset procedure for the installed app. First review every sync account and preserve unsynced work. A reset affects all OneDrive sync connections on that client, including personal accounts, and triggers a full sync. Folder selections may need to be applied again.
Restart OneDrive from Start if needed, then verify the intended accounts and folders. Do not repeat resets while a full scan is progressing. Stop if the account, selected location or preserved files do not match the plan.
Reset the installed Windows sync app, once
Use this only for the client-only branch after preserving unsynced work. These are Windows Run dialog commands, not PowerShell commands.
Press Windows + R, run the first line below. Try the next installation path only if Windows says it cannot find the executable. Stop after one command successfully starts the reset.
%localappdata%\Microsoft\OneDrive\onedrive.exe /reset
"C:\Program Files\Microsoft OneDrive\onedrive.exe" /reset
"C:\Program Files (x86)\Microsoft OneDrive\onedrive.exe" /resetOpen OneDrive from Start. Check every account and reapply folder selections where needed. Let the full scan progress, then use the upload/download checks below. Record the time and remaining activity instead of restarting the reset during the scan.
A reset rebuilds sync settings and connections. It does not restore an earlier cloud file or prove that every local edit had uploaded. Microsoft: Reset OneDrive.
Verify both directions with disposable content
If copies disagree or a new deletion appears, pause the affected sync and keep both versions for the owner. A reset has no single undo button; recover content from preserved copies or the file-recovery workflow, then restore the intended sync configuration with support.
Prepare the sync handoff
Problem: OneDrive sync on Windows Account/location verified internally: Windows and OneDrive versions: Exact activity-panel error and time with UTC offset: One file / one client / many users: Browser result and unsynced copies preserved: Correction, reset scope if any and observed progress: Upload/download/original-file test results: Remaining difference / next owner:
Request sync support with a redacted summary. Keep company paths, account identities and file contents out of the initial enquiry.