![OneDrive This File Can't Be Synced — 12 Fixes That Actually Work [2026]](/images/blog/onedrive-file-cant-be-synced-fix-hero.webp)
Your OneDrive icon is buried under a sea of red X's and blue exclamation marks, and half your files won't upload no matter how many times you right-click "Sync now." "This file can't be synced" is one of the most common tickets we see at IT Cares, and it triggers real panic — people assume they're about to lose work, or that OneDrive itself is broken. In our own support-ticket history, the split is telling: the overwhelming majority of "can't be synced" tickets trace back to something as small as a forbidden character in a single filename, not an actual Microsoft outage or a corrupted account. The fix is usually a rename, not a reinstall.
This guide walks through all 12 fixes, ranked from fastest (check the sync problems list, rename the offending file) to the "nuclear" options (reset the sync engine, unlink and relink your account, full reinstall). It covers Windows and Mac, personal OneDrive and OneDrive for Business / Microsoft 365, and explains exactly what each sync status icon means so you're not guessing.
What makes this error frustrating is that OneDrive's error messages are deliberately generic. "This file can't be synced here" doesn't tell you which rule was broken — it could be a bad character, an oversized file, a name collision with a reserved system word, or a dozen other things, and the message text looks identical in every case. That ambiguity is exactly why so many people give up and either ignore the red X indefinitely (risking real data loss if they assume something is backed up when it isn't) or resort to disruptive fixes like completely uninstalling and reinstalling OneDrive when a 15-second rename would have solved it. The goal of this guide is to remove that guesswork by giving you the specific, documented cause behind each icon and each error variant.
We'll also cover the difference between a personal OneDrive account (5GB free, or bundled with a Microsoft 365 subscription at 1TB) and OneDrive for Business, which is what most workplace and school accounts actually run on. The two share the same desktop app and the same icons, but OneDrive for Business is built on top of SharePoint Online, which enforces a stricter set of filename rules than personal OneDrive does — a detail that catches a lot of businesses off guard when they migrate years of old files into Microsoft 365 for the first time.
What do the OneDrive icons actually mean?
OneDrive overlays a small badge on top of every file and folder icon in File Explorer (or Finder) to show its sync status. A green checkmark means the file is fully synced. A blue cloud icon means the file is "online-only" under Files On-Demand — it exists in the cloud but hasn't been downloaded to this device yet. A sync/refresh icon (two circular arrows) means the file is actively uploading or downloading right now. A red X means sync failed outright. A blue exclamation mark is a softer "not syncing" warning — the file is out of date but hasn't necessarily failed permanently. All four appear as small overlay badges in the bottom-left corner of the file or folder icon.
OneDrive Sync Icons: What Each One Means
| Icon | Meaning | Action needed |
|---|---|---|
| Green checkmark | File is fully synced and up to date on this device and in the cloud | None — this is the healthy state |
| Blue cloud | Files On-Demand: file is online-only, not downloaded locally yet | None, unless you need offline access — right-click > "Always keep on this device" |
| Sync / refresh arrows | File is actively uploading or downloading right now | Wait — this resolves itself once the transfer finishes |
| Red X | Sync failed — filename, size, permission, or lock problem | Open "View sync problems" to see the exact cause |
| Blue exclamation mark | "Not syncing" warning — paused, signed out, or a folder conflict | Open "View sync problems," check sign-in status |
To see this list at any time: click the OneDrive cloud icon in the Windows taskbar notification area (bottom-right, may be hidden under the "^" arrow) or the menu bar on Mac (top-right). Click the gear / Help & Settings icon, then choose "View sync problems". This opens a filtered list showing exactly which files failed and the specific reason for each one — far more useful than guessing from the icon alone.
It's worth noting that these overlay badges apply per-file and per-folder, and a folder's icon reflects the worst status among the items inside it. A folder showing a red X doesn't necessarily mean every file inside failed — it could be one problem file out of hundreds that are syncing fine. This is exactly why "View sync problems" is more useful than browsing folder-by-folder trying to spot the bad icon visually; on a folder with thousands of files, that single flagged item can be almost impossible to find by eye.
OneDrive on Mac: Where to Find These Same Settings
All of the fixes in this guide apply equally to macOS, but the menu paths use slightly different names, which trips people up. On a Mac, the OneDrive icon lives in the menu bar at the top-right of the screen, not the taskbar. Click it, then click the gear icon (sometimes shown as three dots, depending on your macOS and OneDrive app version) to reach Preferences. From there:
- View sync problems is under the Account tab — click "View online" next to any account showing a sync issue, or look for the notification badge on the OneDrive menu bar icon itself.
- Files On-Demand is controlled from the General tab (Fix 11 below).
- Unlink this Mac is under the Account tab (Fix 12 below) — functionally identical to "Unlink this PC" on Windows.
- The equivalent of the Windows reset command on Mac is a full sign-out and sign-back-in from Preferences > Account > Unlink, since macOS doesn't expose a direct command-line reset flag the way Windows does through Run.
One Mac-specific quirk worth knowing: macOS itself enforces different filename rules than Windows (Mac allows characters like \ and : that Windows and OneDrive don't), so a file created and named entirely on a Mac can sync perfectly fine locally while still tripping OneDrive's Windows-derived naming rules the moment it tries to upload. This is one of the most common causes of "can't be synced" errors specifically on mixed Mac/PC households or offices — a colleague on Windows never sees the problem because Windows itself already blocks those characters at the filesystem level, so only Mac users can accidentally create the offending filename in the first place.
Can't fix it yourself? Skip the trial-and-error.
Our certified bilingual tech remotes in, reads your sync logs, and resolves it on the spot — same day, from $119.99. No fix, no fee.
12 Fixes for OneDrive Sync Errors
Open "View Sync Problems" to Identify the Exact File
Before trying anything else, find out exactly which file is failing and why. Click the OneDrive cloud icon in the taskbar notification area (Windows) or menu bar (Mac). Click the gear / Help & Settings icon, then select "View sync problems" (Windows) or "View online" then the problem indicator (Mac). This opens a list of every file currently failing to sync, with the specific error text next to each one — "invalid file name," "file too large," "file in use," etc. This single step resolves most guesswork immediately and tells you which of the fixes below actually applies to your situation. Do this first every time, even if you're fairly sure you already know the cause — we regularly see users spend 20 minutes renaming a file that turned out to be fine, while the actual problem was a completely different file three folders away.
Rename the File to Remove Forbidden Characters
The single most common cause of "This file can't be synced here" is a forbidden character in the filename. OneDrive (and Windows itself) disallows these characters anywhere in a filename: \ / : * ? " < > |. Files copied from a Mac or from older systems sometimes contain these characters without the user realizing it — a colon in a timestamped filename, a slash in an invoice number, quotation marks copy-pasted from a document title. Right-click the file, choose Rename, and replace the offending character with a dash, underscore, or space. Sync typically resumes within seconds. If the problem file is buried in a large folder and hard to spot visually, remember Fix 1's "View sync problems" list already told you the exact filename — copy it from there and use File Explorer's search box (Ctrl+F) to jump straight to it instead of scrolling manually.
Watch especially for characters that don't look unusual at a glance: a "smart quote" (curly apostrophe) pasted in from Word or a webpage can register as an invalid character even though it looks like a normal apostrophe on screen, and colons hidden inside timestamps like "Meeting Notes 14:30.docx" are a frequent, easy-to-miss offender.
Check for Reserved Windows Device Names
Windows reserves certain filenames for hardware devices, and OneDrive inherits this restriction. If a file or folder is named exactly CON, PRN, AUX, NUL, COM1 through COM9, or LPT1 through LPT9 (with or without a file extension), it cannot sync. This is rare but does happen — usually from an automated export tool or a legacy system that generated the filename. Rename the file to anything else and it will sync normally. This rule dates back to how MS-DOS and early Windows reserved these names for printer and communication ports, and while almost nobody hits it by accident when typing a name manually, it does show up in files exported by older accounting software, industrial equipment logs, or scanned documents that get auto-named "COM1.pdf" by legacy scanning software.
Shorten a Filename or Filepath Over 400 Characters
OneDrive syncs fail when a file's full path — including every parent folder name, the OneDrive root, and the filename itself — exceeds 400 characters total. This happens more often than people expect with deeply nested project folders (e.g., "Client Name / 2026 Projects / Q3 Deliverables / Final Revisions / Client Approved / [long filename].docx"). Shorten folder names higher up the chain, or move the file closer to the OneDrive root, and it will sync. A practical way to estimate this quickly: right-click the file, check Properties, and add up the full path length shown in the location field plus the filename — if you're anywhere close to 400 characters, trimming even one parent folder name by 20-30 characters is often enough to clear the whole subtree of files at once, since the limit applies per-file but a renamed parent folder fixes every file underneath it simultaneously.
Remove Leading or Trailing Spaces and Periods
A file or folder name that starts or ends with a space or a period (".") will fail to sync. This commonly slips in when a filename is copy-pasted from an email subject line or a web page title with trailing whitespace that isn't visible in the file explorer. Rename the file and trim any invisible leading/trailing characters — retyping the name from scratch is the most reliable way to be sure it's clean.
Close the File in Other Programs
If a file is open and exclusively locked by another application — a database file open in an incompatible program, a large Excel workbook with an active connection, or certain Adobe files with an exclusive lock — OneDrive can't read it to upload the latest version. Close the file in every program that has it open, including background processes you may have forgotten about, then check "View sync problems" again to confirm it clears. Accounting software (QuickBooks, Sage) and certain CAD or database applications are especially prone to this because they keep a persistent lock file open even when the main document window is minimized — check your system tray for any icon of that program still running before assuming the file is fully closed. If a lock persists even after quitting the app, a full restart of the computer will always release it.
Check the File Size Against the 250GB Limit
OneDrive does not sync individual files larger than 250GB — this is Microsoft's documented per-file size cap as of recent versions of the sync client. If you're trying to sync a large video export, a VM disk image, or a database backup that exceeds this limit, it will never sync no matter what you try, and it won't produce an especially clear error message pointing to size as the cause — it will simply sit as "pending" indefinitely or show the same generic "can't be synced" red X as every other failure type. Options: split the file into smaller parts using archive software with multi-volume support, keep it web-only by uploading directly through the OneDrive website instead of the desktop sync folder (the website has different, more permissive upload handling for single large files in some cases), or store it outside OneDrive entirely on a dedicated NAS or external drive. In practice, most home and small-business users never approach anywhere near 250GB for a single file — if you're hitting this limit, it's almost always a video project, a virtual machine image, or a full database dump.
Check Your Storage Quota
If new files are stuck showing "pending upload" across the board rather than one specific file failing, you've likely hit your storage quota. Personal OneDrive free accounts get 5GB; a Microsoft 365 subscription includes 1TB; OneDrive for Business quotas vary by license tier (commonly 1TB per user on standard business plans, more on premium tiers). Once you exceed your quota, OneDrive silently stops accepting new uploads — it won't always show an obvious error, just files stuck pending. Check your usage at onedrive.com under Storage, and either free up space, delete old files from the Recycle Bin (which still counts against quota until it's emptied — a step people forget), or upgrade your plan. If you're on a shared family Microsoft 365 subscription, note that each family member's 1TB allocation is separate; one full account doesn't affect the others, so double-check you're looking at usage for the correct sign-in.
Business Users: Watch for SharePoint's Extra Character Restrictions
OneDrive for Business is backed by SharePoint behind the scenes, and SharePoint enforces additional filename restrictions beyond what consumer OneDrive allows. Notably, # (hash/pound) and % (percent) are not permitted in filenames synced through OneDrive for Business or Teams, even though these characters are technically allowed on a personal OneDrive account. This trips up a lot of organizations migrating years of old files where invoice numbers or product codes commonly use "#" (e.g., "Invoice #4521.pdf"). Rename any file containing these characters before it will sync to a business account. This one catches IT departments off guard specifically because a file with a "#" in the name will sync perfectly fine on a personal OneDrive test account, leading someone to (incorrectly) rule out the filename as the cause before they realize the production environment is OneDrive for Business, not personal OneDrive, and the two enforce different rules. If you're doing a bulk migration of legacy files into Microsoft 365, it's worth running a filename audit for "#" and "%" characters before the migration rather than after, since fixing hundreds of files retroactively is much slower than a single pre-migration cleanup pass.
Fix Known Folder Move Conflicts (Duplicate Desktop/Documents)
OneDrive can be configured to automatically back up your Desktop, Documents, and Pictures folders — a feature called Known Folder Move. When this is misconfigured (for example, enabled on two devices signed into the same account with different local folder structures), it commonly creates a duplicated folder like "Desktop" and "Desktop (username's PC)" both showing up, with sync conflicts between them. Go to Settings > Sync and backup > Manage backup to review which folders are being redirected, and merge or rename the duplicated folder manually to resolve the conflict.
Free Up Local Disk Space with Files On-Demand
If sync is stalling because your device's local disk is nearly full, enable Files On-Demand: open OneDrive Settings, go to the Settings tab, and check "Save space and download files as you use them." This keeps most files as online-only placeholders (the blue cloud icon) rather than storing a full local copy of everything, which frees up significant disk space and often resolves sync stalls that were actually caused by the local drive running out of room rather than any problem with the files themselves.
Reset the OneDrive Sync Engine (the "Nuclear" Fix)
If individual file fixes don't resolve the problem, or if sync is broadly stuck across many unrelated files, reset the sync engine without touching any of your actual files. Press Windows key + R to open the Run dialog, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. This clears the corrupted local sync database and forces a fresh sync state — your files are never deleted, either locally or in the cloud. OneDrive should relaunch automatically within a minute or two. If the taskbar icon doesn't reappear, open the Start menu, search "OneDrive," and launch it manually. If a full reset still doesn't fix it, go to Settings > Account > "Unlink this PC," then sign back in with your Microsoft or work account — this clears corrupted authentication tokens and rebuilds the local sync database from scratch.
Red X vs. blue exclamation mark: which is more urgent?
A red X means a specific, identifiable problem is blocking that file — usually fixable in under a minute once you know the cause. A blue exclamation mark is often broader and can mean OneDrive itself is paused, you've been signed out, or there's a folder-level conflict (like a Known Folder Move duplicate). If you see blue exclamation marks across many files at once rather than one isolated red X, check your sign-in status first — click the OneDrive icon and confirm your account still shows as connected before digging into individual files.
How to Prevent OneDrive Sync Errors Going Forward
Once you've cleared the current backlog of failed files, a few habits keep new sync errors from piling up again:
- Standardize a filename convention for teams — spell out which characters are off-limits (especially
#and%for business/M365 accounts) in your onboarding documentation. Most sync error waves in an office come from one person's habit, not random chance. - Keep folder structures shallow. Every extra layer of nested folders eats into the 400-character path limit. A flatter structure with a good naming/tagging convention is both easier to search and less prone to path-length failures than deep nesting.
- Enable Files On-Demand by default on laptops with smaller SSDs (256GB or less) so local disk space doesn't silently become the bottleneck — see Fix 11 above.
- Check your storage quota monthly if you're regularly uploading large files (photography, video, CAD work) — catching an 80%-full quota before it hits 100% avoids the "silent pending upload" problem entirely.
- Avoid copying files from other cloud services (Dropbox, Google Drive, iCloud) directly into a OneDrive folder without a quick filename check first — each service has slightly different naming rules, and files that were perfectly valid in one system can trip OneDrive's stricter Windows-derived rules.
- Review "View sync problems" weekly if you manage a shared team folder — small errors compound quickly when multiple people are dropping files into the same synced location, and catching one bad filename early is much faster than untangling a dozen at once.
Why "This File Can't Be Synced" Almost Never Means OneDrive Is Down
Many users assume "This file can't be synced" means Microsoft's servers are having an outage, and they'll wait hours or even days for it to "fix itself." In the cases we see at IT Cares, that's very rarely the actual cause. OneDrive's sync engine validates every file against a strict set of naming and size rules before it attempts to upload — a validation failure produces the exact same red X and the exact same generic-sounding error text as a real connectivity problem, which is why the two get confused so often.
The practical difference matters: a real service outage affects every file and typically resolves within minutes to a couple of hours, visible on Microsoft's service status page. A validation failure affects only the specific non-compliant file(s) and will never resolve on its own, no matter how long you wait — the file needs to be renamed, resized, unlocked, or moved. If "View sync problems" shows one or two specific files rather than your entire library, you're dealing with a validation issue, not an outage, and the fastest path forward is Fix 1 through Fix 6 above.
There's a second, related myth worth addressing: that OneDrive "loses" files when sync fails. In every non-syncing scenario covered in this guide, the file itself is completely safe — it simply remains on your local hard drive exactly as it was, just not mirrored to the cloud copy or to your other devices yet. The risk isn't data loss from the sync failure itself; it's the indirect risk of a user assuming a file is backed up in the cloud when it actually isn't, and then losing the only copy through an unrelated hard drive failure. This is exactly why we recommend checking "View sync problems" as a habit rather than only when something visibly breaks — a red X sitting unnoticed for weeks means weeks of local-only, unprotected work.
If you've worked through every fix above and a file — or your entire account — still won't sync, the remaining causes are usually environmental rather than file-specific: a corporate firewall or antivirus product blocking OneDrive's connection endpoints, a VPN routing traffic in a way that interferes with the sync client's persistent connection, or in rare cases a genuinely corrupted OneDrive installation that needs a full uninstall and reinstall from Microsoft's official download page. At that point, a technician who can inspect your specific sync logs will get you back up and running faster than continued trial and error.
OneDrive Still Won't Sync?
IT Cares offers remote OneDrive and Microsoft 365 troubleshooting for home and business users across Canada: sync engine resets, SharePoint permission fixes, storage cleanup, and full account migrations. Most sessions resolved same-day.
Frequently Asked Questions
What does the red X icon mean on a OneDrive file?
A red X overlay badge means OneDrive tried to sync that file and failed. Click the OneDrive cloud icon in the taskbar, then the gear/Help & Settings icon, then "View sync problems" to see the exact file and reason — almost always a forbidden character, oversized file, reserved device name, or a file locked open by another program.
What causes the blue exclamation mark on OneDrive?
A blue exclamation mark is OneDrive's "not syncing" warning — less severe than a red X but still meaning the file or folder isn't current in the cloud. Common causes: sync is paused, you're signed out, the local OneDrive folder was moved or renamed outside the app, or a Known Folder Move conflict created a duplicate folder.
Why does OneDrive say "This file can't be synced here"?
This exact message almost always points to a filename or filepath problem, not a service outage: a forbidden character (\ / : * ? " < > |), a reserved Windows device name (CON, PRN, AUX, NUL, COM1-9, LPT1-9), a filepath over 400 characters, or a name that starts/ends with a space or period. Business/M365 users on SharePoint also can't use # or %.
How do I completely reset OneDrive without losing my files?
Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. This resets the sync engine and local database without deleting any files — everything stays exactly where it is, locally and in the cloud. OneDrive relaunches automatically within a minute or two; if not, search "OneDrive" in the Start menu and launch it manually.
Why is OneDrive stuck on "Processing changes" or not uploading new files?
The most common cause is a full storage quota — personal OneDrive free accounts get 5GB, and once you hit that limit, new files silently stop uploading and show as "pending." Check your quota at onedrive.com under Storage. Other causes: a file exceeding the 250GB per-file sync limit, a paused sync session, or a corrupted local sync database needing the onedrive.exe /reset command.
Comments (3)
Had a red X on a client invoice folder for two days and assumed OneDrive was just broken. Turned out one invoice had a colon in the filename from a timestamp I'd copy-pasted. Renamed it and every file synced within 10 seconds. Wish I'd checked "View sync problems" on day one instead of waiting.
The onedrive.exe /reset command saved me. Whole Documents folder was showing blue exclamation marks and nothing I tried worked — pausing, resuming, restarting the computer. Ran the reset command from the article, waited two minutes, and everything came back green. Didn't lose a single file.
We migrated 8 years of old project files into OneDrive for Business and half of them wouldn't sync. Turned out to be the # character in our invoice numbering system — didn't know SharePoint blocked that even though regular OneDrive allows it. Batch-renamed everything and it cleared right up. This explanation was more useful than Microsoft's own support docs.
Leave a Comment