If OneDrive is stuck on “Sync pending”, open its cloud icon and look for the specific file or warning holding up the queue. Check whether syncing is paused, save and close open documents, and try one small test file. Preserve unsynced work before moving files, resetting OneDrive or unlinking an account.
This guide focuses on OneDrive for Windows. The same account, activity and file checks can help on macOS, but Finder and menu-bar controls differ. Personal OneDrive and work or school accounts can also have different restrictions.
First, distinguish pending sync from an online-only file
A blue cloud beside a file means it is stored online and can be downloaded when needed. That is not itself a failed upload. Circular arrows indicate activity, while a red cross or an account warning calls for closer inspection. A folder can show a pending state because of an item inside it.
Use Microsoft’s OneDrive icon guide to match the symbol you actually see. Do not delete or recreate folders simply because they have cloud icons. A document you can open locally is also not proof that its newest edits have reached the cloud.
1. Read OneDrive’s activity list
- Select the OneDrive cloud in the Windows notification area. Check hidden tray icons if necessary.
- Confirm which account the window represents. A personal account and an employer’s account may both be running.
- Read any error and note the filename, folder and time of the latest successful activity.
- If syncing is paused, resume it. If sign-in is required, complete it through the official app.
Microsoft explains where these controls live in its OneDrive settings guide. Record the actual message before trying a fix; “not signed in”, a storage warning and a file naming problem need different responses.
2. Use one small file to narrow down the problem
Create a small, non-sensitive text document with a simple name such as sync-check.txt in your own synced folder. Wait for activity to settle, then check for the file through OneDrive’s website using the same account. Open it and confirm its contents rather than relying only on a filename.
- The test file uploads: investigate the original item, its parent folder or its permissions.
- Nothing new uploads: check the account, connection, storage and app state.
- The website has the file but Explorer still says pending: compare file contents and timestamps before treating the badge as proof of lost data.
This comparison is a troubleshooting method, not a guarantee that the rest of the queue is healthy. Keep the failing file and the successful test separate so you can describe the difference to support.
3. Save and close the application using the file
A document still open for editing, a large archive or many recent changes can prolong syncing. Save your work and close the relevant application normally. Avoid ending a process while it contains unsaved changes.
Watch whether the pending count decreases. A large upload that continues progressing needs time; a single filename that never changes deserves investigation. Microsoft’s Processing changes guidance lists open files, large files and large queues among the possible explanations.
Do not keep rewriting or resaving a large file during this comparison. That makes it harder to tell whether OneDrive is processing the original upload or a newer revision.
4. Check hidden and temporary files carefully
If a folder remains pending even though its visible documents look complete, inspect its contents for temporary or hidden items. Turn on hidden-item display in File Explorer only to identify the item; seeing an unfamiliar file is not a reason to remove it.
Microsoft says temporary .TMP files do not sync to OneDrive. These files can also hold working or recovery data. Its Sync pending instructions warn that moving, renaming or deleting them may break their original use or lose unsaved work.
Save and close the application that created the temporary file, then restart the computer if needed. If you cannot identify its purpose, leave it in place and seek application-specific advice. Do not use a blanket “delete all TMP files” cleanup.
5. Check names, paths, permissions and both storage limits
Read the warning for invalid characters, blocked file types or an overly long path. Microsoft’s OneDrive and SharePoint restrictions are the reference for the account and destination you use.
If you change a filename, preserve its real extension and consider whether another document or application depends on that path. For shared work material, ask the owner or administrator about access rather than copying sensitive files into a personal account.
Check the free space on the computer and the storage available in the OneDrive account. These are separate limits. If the error identifies one as full, address that specific limit instead of repeatedly restarting the app. Keep an independent copy of important unsynced work before cleaning up a synced folder.
6. Restart before considering a reset
Once work is saved, quit and reopen OneDrive, or restart the computer. Repeat the small-file comparison and inspect the activity list again.
If the issue remains, follow Microsoft’s official reset procedure for your platform. A reset rebuilds sync state and can trigger a full check of the files. It is a later troubleshooting step, not proof that the original file has uploaded. Preserve unsynced changes first and allow the subsequent sync to finish.
Confirm the result before removing your safety copy
Verify the original problem file on OneDrive’s website, including its recent edits. Then check that a new small file travels successfully in the direction you need. Keep your separate safety copy until you have established that both the existing work and new changes are accounted for.
If the same item still blocks progress, send support the exact message, account type, filename extension, approximate size and whether the control file worked. Share private documents only through an approved support channel. Deleting a file from an actively synced folder can affect its cloud copy, so deletion should never be a casual way to hide a pending badge.
