OneDrive is quiet when it works and confusing when it does not. A user sees a blue arrow icon for days, a file that will not open because it is "online-only" on a plane, or a document that saved on one laptop and never appeared on the other.
Nearly all of these come down to a short list: a file name or path OneDrive will not accept, a file held open by another program, a stuck client that needs a reset, or a misunderstanding about what Files On-Demand does. Here is how to work through them.
Read the icon and the activity center
Click the cloud icon in the system tray. The activity center at the top tells you the state in one line: Up to date, Processing changes, Syncing N files, Paused, or a red banner naming a problem. Click the banner. OneDrive usually says exactly which file it cannot sync and why, and the fix is in the message.
In File Explorer, the status column icons matter too. A blue outlined cloud is online-only, a green outlined tick is downloaded and can be freed up later, a solid green tick is always kept on the device, blue circular arrows mean pending, and a red circle with an X means a sync failure on that item. A padlock means the file is read-only because of a policy or someone else's lock.
The usual blockers
When a single file or folder will not sync, it is almost always one of these.
- Invalid characters in the name: " * : < > ? / \ | and a name that starts or ends with a space or a period. Rename the file.
- Temporary and lock files: anything starting with ~$ or ending in .tmp is ignored by design. Close the Office document and the lock file goes away.
- Path too long. The full path including the OneDrive folder and the file name has a limit of around 400 characters. Move deep folder trees closer to the top.
- A file open in another program. Outlook PST files, Access databases and QuickBooks company files are the classic ones. They should not live in OneDrive at all.
- Permission changes on a shared library. If the user lost access to a SharePoint library they were syncing, that library shows an error until it is removed from sync.
Reset the client
If the activity center is stuck on Processing changes for hours with no named file, or the icon shows the client is signed in but nothing happens, reset it. A reset does not delete files. It clears the client's local state and makes it re-scan and re-index everything, which can take a while on a large library, so warn the user. The command below works on current Microsoft 365 builds; if OneDrive does not restart within a couple of minutes, launch it from the Start menu.
Before resetting, check the obvious. Is the user signed in to OneDrive with the right account? Is sync paused because the laptop is on a metered connection or battery saver? Settings > Sync and backup in the OneDrive client has both toggles. And check the account's storage quota in the Microsoft 365 admin center; a full quota stops all uploads with a message users often miss.
%localappdata%\Microsoft\OneDrive\onedrive.exe /resetFiles On-Demand explained
Files On-Demand keeps every file visible in Explorer while only downloading the ones the user opens. That is what people want on a small SSD, and it is what confuses them on a flight. An online-only file cannot open without a connection. Right-click a folder and choose Always keep on this device for anything the user needs offline, such as a current projects folder, and leave the rest online-only.
Storage Sense can turn downloaded files back into online-only after a set number of days under Settings > System > Storage > Storage Sense > Locally available cloud content. That is usually what happened when a user says a file "disappeared" from their laptop. It is still there, one click away, but it needs a connection. Show the user the icons once and this ticket mostly goes away.
attrib +P -U "C:\Users\jsmith\OneDrive - Contoso\Projects" /S /DWhen it is the tenant, not the laptop
Some sync problems are caused by settings in SharePoint or Intune. A library with a retention or sensitivity policy that requires check-out, or a library where Offline client availability is set to No in Library settings, will not sync. Known Folder Move policies that redirect Desktop and Documents can fail on machines that already had those folders redirected to a file server, and the OneDrive client reports it.
If the same error is showing on many laptops at once, look at the OneDrive sync health report in the Microsoft 365 Apps admin center before you touch any client. It shows errors per device and per user, and it is the quickest way to tell a tenant problem from a laptop problem.
Frequently asked questions
Will resetting OneDrive delete my files?
No. The reset clears the client's local database and settings and re-syncs from the cloud. Files that were still uploading may need to be re-added, so check the activity center for pending items before you reset.
Why is a file online-only when I never chose that?
Storage Sense frees up space by turning files you have not opened recently back into online-only. Mark the folders you need offline as Always keep on this device.
Takeaway
Start with the activity center, because OneDrive usually names the file and the reason. Fix the name, the path or the open file, check quota and pause settings, and reset the client only when nothing is named. Teach users the three icons and Always keep on this device, and most of the Files On-Demand tickets close themselves.