You save a file and the little cloud icon never settles, or a colleague says they cannot see the document you finished an hour ago. Sync problems are the single most common thing our clients ask us about, and most of them come down to one stuck file, a disk with no room left, or a sign-in that has quietly expired.

Try this first

1. Read what the OneDrive icon is actually telling you. Look for the small cloud icon in the system tray, next to the clock at the bottom right of your screen. On a Mac it is at the top right. You may need to click the small upward arrow to reveal hidden icons. Click the cloud once and read the message at the top of the panel. That message is the most useful thing you can give us, so take a screenshot of it before you change anything.
2. Check the colour of the icon. A blue or white cloud means it is idle and up to date. Two arrows going in a circle mean it is still working, so give it time. A grey cloud means you are signed out. A red X almost always means an account or permission problem rather than a broken file. A yellow triangle usually means one specific file is stuck and everything else is fine.
3. Pause and resume sync. Click the cloud icon, click the gear (settings) icon at the top of the panel, choose Pause syncing and pick 2 hours. Wait a minute, click the gear again and choose Resume syncing. This clears a surprising number of jams, because it forces OneDrive to ask the server for a fresh list of what has changed instead of trusting the list it already has.
4. Check you have free disk space. Open File Explorer, click This PC, and look at the bar under your C: drive. If there is less than a few gigabytes free, sync stalls quietly. Emptying the Recycle Bin and clearing out your Downloads folder is usually enough to get things moving.
5. Check the file path is not absurdly long. Windows gives up at around 250 characters for the whole path, which is every folder name and the file name added together. A file called Final version approved by the board 12 March.docx sitting six folders deep will hit that limit. Shortening one folder name near the top of the chain fixes everything beneath it.
6. Check for characters Windows will not accept. These are the troublemakers in a file or folder name: " * : < > ? / \ | A name also cannot end in a space or a full stop. Dates written as 12/03/2026 are the usual culprit, because the slashes look like folder names to Windows. Use 12-03-2026 instead.
7. Sign out and back in. Click the cloud icon, then the gear, then Settings, then Account, then Unlink this PC. Sign back in with your work email address. Nothing is deleted when you do this, but it does take a while to re-check every file, so start it when you can leave the computer alone for a bit.

If that didn’t fix it

The next step is a full reset of the sync client. That is a legitimate fix and we do it often, but it re-downloads everything and looks alarming while it runs. Ask us to do it rather than following a set of instructions you found online, because some of those instructions do remove local copies of files.

When you log the ticket, tell us four things: the exact wording of the message on the OneDrive panel, the colour of the icon, whether it is your own OneDrive or a shared SharePoint or Teams library that is stuck, and the name of any file it has singled out. With those four we can usually work out the cause before we connect to your computer.

Why this happens

OneDrive keeps a local list of every file and compares it against the server’s list. Anything that stops that comparison finishing - a name it cannot write to disk, a password change that invalidated the sign-in, a disk with nowhere to write - stops the whole queue rather than just the one file. That is why a single bad file name can look like everything has stopped.

Related

• A folder has gone missing: how to find it and get it back
• Duplicate files with your computer's name on them: sync conflicts
• Files will not open offline: understanding Files On-Demand
• Why your Desktop and Documents folders live in OneDrive

Still stuck?

Log a ticket at portal.yougrowit.com.au or email support@yougrowit.com.au. If it is stopping you working right now, call 03 9028 4358.

Support hours are Monday to Friday, 8:30am to 5:30pm Melbourne time, excluding Victorian public holidays.

Not a client yet?

This help centre is free to read and we would rather you fixed it yourself. If it has not worked, or you would rather someone just dealt with it:

The first call is free. Tell us what’s happening and we’ll tell you what we think it is, what fixing it involves, and what it’ll cost — before anything is charged. If it turns out to be a five-minute thing, we’ll usually just sort it out on the call.

Call 03 9028 4358 or email admin@yougrowit.com.au. Melbourne small businesses, Monday to Friday 8:30am–5:30pm. We don’t do home computers.