One file has a spinning arrow next to it and everything else is fine. Or the whole folder has stopped, and OneDrive is showing a small red cross it will not explain.
Before you sign out, reset anything or reinstall it, look at what the file is called. Microsoft publishes a list of characters that simply cannot sync. One of them turns up more often than you would guess.
A business account failing during old Mac setup has a company-name slash workaround, separate from renaming an uploaded file.
I checked the OneDrive state on this machine first. One stuck file and a stopped account are different problems, and that is the first thing to establish.
In this guide
One file or all of them
Two very different problems look alike in the taskbar. If one file is spinning while the rest are ticked, OneDrive is running fine and that file is being rejected.
If a spreadsheet uploads but its browser editor refuses it, check the workbook's contents before resetting sync.
Everything stopping at once points at the account, the storage or the connection.
For a Synology task returning 429, check Cloud Sync throttling and authentication before rebuilding its folders.
When a work library never opens and reports OneDrive not provisioned, check the account's site creation rather than individual filenames.
For a phone-only connection warning, compare Android OneDrive on Wi-Fi and mobile data before changing the computer's sync setup.
When Word alone refuses AutoSave with a privacy warning, check Word's license and connected experiences before rebuilding the sync connection.
For a browser response of 503, check OneDrive service access before rebuilding the sync folder.
When a work address changed just before uploads stopped, check the OneDrive domain transition before rebuilding the folder.
When access fails across devices, check OneDrive service availability for the personal account or organization involved.
For shared work documents that never appeared locally, connect the SharePoint library to File Explorer before troubleshooting individual filenames.
If the cloud rejects your login, separate account access from app trouble before renaming documents.
Read on this machine: OneDrive is running and the folder is in place. That is the normal state, and the one to compare yours against.
For an open CAD drawing, close AutoCAD's drawing before waiting for sync; its saved revision can remain local until then.
When folder setup itself is refused, start with the add-folder account repair and read the cloud status before moving files.
A blue cloud means online-only, which is also why photos in those folders can show plain icons.
Open the OneDrive icon in the taskbar and read the message. It usually names the file. People close it without looking.
No cloud icon after launching the app calls for OneDrive startup repairs, including a check for a work-policy block.
A popup naming No such interface supported needs the legacy OneDrive client checks before a reset of the current app.
For dates displayed in an unexpected format on OneDrive's website, choose the matching regional preference instead of resetting sync.
If files appear online but another person cannot reach them, check the folder invitation separately from the sync status.
When a working sharing link arrives only in a manual email, check missing OneDrive invitations separately from uploads.
A warning naming the protected folder calls for the Personal Vault error checks before a general sync reset.
The characters that can never sync
This is the commonest single cause and it is completely invisible.
Microsoft prints the list itself, on its restrictions page.
These characters are not allowed in a file or folder name:
" * : < > ? / \ |
A colon is the usual culprit. People type a time, or a title with a colon in it, and the file never syncs again from that moment. Microsoft also states: "Leading and trailing spaces in file or folder names also aren't allowed."
A trailing space is impossible to see. When one file sticks I rename it and retype the whole name rather than editing it, which takes five seconds and removes whatever you cannot see in there. Then watch it sync within seconds.
And the names that are blocked outright
Shorter list, and it catches the technically-minded. Microsoft names them: ".lock, CON, PRN, AUX, NUL, COM0 - COM9, LPT0 - LPT9, _vti_, desktop.ini, any filename starting with ~$".
The last one matters most for you. Files beginning with a tilde and a dollar sign are Office's own temporary files, and Word and Excel leave them behind when they close badly.
So a folder that will not finish syncing often has an abandoned Office temp file in it. Delete those and it moves on. CON, PRN and AUX are ancient device names that Windows still reserves, and if you named a folder AUX, that is why.
The two limits worth knowing
Numbers, so you can rule them out quickly. Microsoft states the ceiling for a single upload: "250GB". Almost nobody hits that.
A large file accepted for storage can still hit a OneDrive web-copy restriction; use the synced folder for several-gigabyte copies.
The one people do hit is the account itself. Microsoft says: "If you exceed your Microsoft storage, you won't be able to upload, edit, or sync new files (such as Camera Roll) to your OneDrive."
Note the wording. Not just new files, editing existing ones stops too, and a full account feels exactly like a broken one. When everything has stopped at once, check your storage first. It is one line on the OneDrive settings screen.
A recent purchase with an unchanged allowance needs the OneDrive upgrade checks before another sync reset.
A work account whose allowance suddenly fell to 2GB needs a license and quota review before deleting files to fit the smaller limit.
For a separate network share, Windows error 0x80070718 can refer to the local Offline Files cache rather than OneDrive storage.
Paths that are too long
Real, common on shared folders, and it has no obvious symptom. Microsoft lists it as its own problem to fix, and the full path is every folder name plus the file name, added together.
A file three folders deep can exceed the limit even when its own name is short. Microsoft says different apps and Office versions have different limits. So it does not print one number.
An Excel file-access error can also come from a long workbook path or an editing lock, even while other OneDrive files sync normally.
The fix is to shorten a folder name, not the file. Renaming one folder near the top pulls every file inside it back under.
A PDF that never gets created needs a local-save comparison before troubleshooting its upload.
Copying deep folders like these to a backup drive runs into a limit in File Explorer too, and robocopy carries them across with the names intact.
A USB backup that stops with 0x80070052 despite free space needs a destination-folder and file-system check.
When to reset rather than reinstall
Ours, and in this order. Close OneDrive from the taskbar icon and open it again. A surprising share of stuck syncs clear right there. Then sign out and sign back in, which Microsoft describes as unlinking and relinking the account.
A reset re-reads every file rather than deleting anything. Your files stay put and it can take a while on a big folder.
For Finder error -43, reconnect OneDrive on the Mac before using the edition-specific reset script.
When sign-in instead stops at 0x8004de40, follow the OneDrive connection-code repair before rebuilding sync settings.
Reinstalling is almost never the answer. It does the same work as a reset with extra steps, and people reach for it first.
If the app has already been removed, restore OneDrive and verify its account before returning to the stalled-file checks.
One case where reinstalling can trap you: OneDrive's Bad Image error on an S mode PC, which the Bad Image page explains.
What syncing is not
Three misunderstandings cause most of the panic. OneDrive is not a backup. Delete a file on the PC and it deletes in the cloud, and that is the design.
A workbook gone from OneDrive but still visible in Excel on iPad needs the ghost-file checks, rather than repeated cloud deletion.
Files On-Demand means a file can exist without being downloaded. A cloud icon is not a failure, it is a file you have not opened yet.
On a phone, check the OneDrive workbook location and Android format support when an Excel file seems missing or opens read-only.
To plan work without internet, choose OneDrive offline availability before leaving the connection behind.
For a game launcher stopped at its update check, check FFXIV's code and Documents access before changing folder backup.
And moving your Desktop and Documents into OneDrive is a separate feature. If your folders moved without you asking, that is what happened.
On this machine that folder redirection is not switched on, worth knowing when you compare yours.
If File Explorer stops showing those sync badges while your files keep syncing, a OneDrive reset brings the Status column back.
An extra OneDrive in File Explorer's navigation pane is a sign-in leftover rather than a sync fault, and one registry value hides it.
Files you sent with Edge's Drop also sit in OneDrive, and now that Drop is retired, the Edge Drop page shows how to find them.
When it really is broken
Three honest endings. When the same file fails after a clean rename and a reset, copy your content into a brand new file and delete the old one.
If the old business file refuses deletion, check its OneDrive editing lock before another sync reset.
If sync stops only on one network, that is a firewall or a captive portal, not OneDrive. Work out whether the service or the connection is the problem.
Or nothing has synced for days and the icon shows no error at all. That is the case for signing out and back in.
When OneDrive never settles and keeps scanning with the fan running, something is writing into a synced folder.
Status: Microsoft's OneDrive restrictions page quoted on 28 August 2026, with the local sync state checked. No file name, folder name or file content was read or published.
Why will one file not sync to OneDrive?
Almost always its name. In your case too, most likely. Microsoft blocks the characters " * : < > ? / \ and the pipe, and it does not allow leading or trailing spaces.
A colon typed into a title is the usual culprit, and a trailing space is invisible. Rename the file cleanly and it usually syncs within seconds.
What file names does OneDrive not allow?
Besides the blocked characters, Microsoft names .lock, CON, PRN, AUX, NUL, COM0 to COM9, LPT0 to LPT9, _vti_, desktop.ini, and any file name of yours starting with a tilde and a dollar sign.
That last one is Office's own temporary file, and abandoned ones stop a whole folder finishing.
A file already called nul or con on your PC is harder to shift, because Windows' own delete refuses the name. Command Prompt removes it with a path prefix.
Why has OneDrive stopped syncing everything?
Check your storage first. Microsoft says that if you exceed your Microsoft storage you cannot upload, edit or sync new files, so editing existing ones stops as well.
If storage is fine, close OneDrive from the taskbar and open it again, then sign out and back in.
Should I reinstall OneDrive to fix syncing?
Almost never. Signing out and back in does the same work with fewer steps, and a reset re-reads your files rather than deleting them. Reinstalling is what people try first and it rarely adds anything the simpler steps have not already done.
The Short Version
- One stuck file and a whole stopped account are different problems.
- Microsoft blocks " * : < > ? / \ and the pipe in file names.
- A colon in a title is the commonest cause of a single stuck file.
- Leading and trailing spaces are not allowed either, and are invisible.
- Names starting with a tilde and a dollar sign are Office temp files.
- A full Microsoft storage account stops edits, not just new uploads.
- Long paths break sync even when the file name itself is short.
- OneDrive is not a backup. Deleting on the PC deletes in the cloud.
Where to Next
Click the OneDrive icon in the taskbar and read what it says. It usually names the file, and most people close that message without looking.
If it is one file, look hard at the name for a colon, a slash or a space at the end. Rename it cleanly and watch it go.
If everything has stopped, check your storage before anything else. A full account stops edits as well as uploads.
Only then close OneDrive and reopen it, and after that sign out and back in. Leave reinstalling alone.
If a file of yours refused to sync for a reason none of this covers, tell me what it was called in the comments, minus anything private. That list would help a lot of people.







