Identify Whether Uploads Or Downloads Are Failing
OneDrive not syncing files can interrupt an entire workflow, particularly when you expect to edit a document on one computer and see the changes on another. The most important first step is to identify whether the missing change originated on the computer or in the cloud. These two failures may look similar in File Explorer or Finder, but they involve different directions of synchronization.
Open the OneDrive folder on the affected computer and find a specific document whose status you understand. Note its name, location and most recent modification time. Then sign in to the official OneDrive website using the same account and locate the equivalent folder. Inspect the actual file rather than relying only on the filename. Two files with similar names can have substantially different contents or belong to separate accounts.
If the computer contains an updated document but the website shows an older copy, investigate an upload problem. If the website contains a newer version but the computer continues showing the previous content, investigate downloads or local availability. If neither location contains the expected document, stop and locate available backups before undertaking broad repairs.
Try a freshly created, non-sensitive test document in the affected folder. Give it a distinctive name so that you can identify it on the website without confusing it with an existing file. Avoid testing by overwriting an important document, since simultaneous changes might create a conflict.
The comparison separates a synchronization problem from misunderstanding the storage model. Our guide to how cloud computing and storage work explains why an online copy and the corresponding local representation are related but not always identical at every moment.

Protect Unsynced Files Before Changing OneDrive Settings
Before trying a reset, account reconnection or folder cleanup, protect files that may exist only on the affected computer. A file that has been edited while the sync client was disconnected may not yet have reached Microsoft’s servers. An online copy of the document’s previous version is not a backup of your latest local edits.
If you can open the affected local file, save your work and close its editing application. Copy the file into an appropriate location outside all OneDrive-managed folders, or use a suitable independent backup device. On a privately managed computer, verify the destination path carefully so that the new copy is not inside another synchronized library. Open the copied document to confirm that it contains your current work.
For company documents or regulated data, use only approved backup methods and storage locations. Copying sensitive workplace files to a personal account or unauthorized removable drive may violate organizational policy. Consult the responsible administrator if you cannot preserve important local work safely.
Files that exist only online require a different approach. A visible placeholder is not a complete offline file. Check the website and download an authorized copy if you need independent access. Do not assume that copying an unavailable placeholder has preserved the underlying file.
Avoid deleting the entire local OneDrive directory as a troubleshooting shortcut. Deletions inside a synchronized location can propagate to the cloud and other devices when synchronization resumes. Our Windows backup software comparison explains why an independent backup is valuable even when you use cloud synchronization every day.
Read The OneDrive Status And Error Messages
On Windows, locate the OneDrive cloud icon in the notification area. You may need to expand the hidden icons. On a Mac, inspect the menu bar or open OneDrive from Finder or Spotlight if the application is not running. Select the relevant icon to open the activity and status view.
Different symbols communicate different conditions. An error marker calls for examining the affected files, while moving synchronization arrows indicate ongoing activity. A paused indicator tells you that the client is not currently transferring changes. A sign-in warning may mean that the application cannot establish the necessary account session.
Microsoft’s OneDrive icon reference explains the various status, sharing and availability indicators. Interpret the actual icon shown on your operating system rather than assuming that every status symbol is an error.
Read the accompanying message and identify the affected account or file. A single invalid filename can produce a warning even while many other items continue to synchronize. A missing application icon, in contrast, may indicate that the desktop client simply has not started.
Write down any code exactly as displayed, together with the approximate time and the operation in progress. The Microsoft OneDrive error reference can help you connect a recorded code with its documented cause and repair options.
Avoid repeatedly clicking an action without inspecting the result. If the same warning returns after a normal restart, the error details provide better direction than repeating the restart indefinitely.
Confirm That The Desktop Client Is Running And Signed In
OneDrive synchronization depends on the desktop sync application operating under the correct account. Finding a OneDrive folder in File Explorer does not establish that its background service is active. Older folders can remain on disk even after an account has been disconnected.
On Windows, search for OneDrive in Start and open the desktop application if necessary. On macOS, locate it in Applications or use Spotlight. Let the client display its status and review the account listed in its settings. If prompted to sign in, use the official application or a verified Microsoft sign-in page.
Compare the email address and account type with the identity used on the OneDrive website. A personal Microsoft account and an organizational account may contain entirely different sets of files. On a shared computer, confirm that you are working within your own operating system profile and authorized cloud account.
If the password changed recently or the organization requires additional authentication, complete the legitimate sign-in process. Avoid submitting credentials to unexpected pages that claim to fix a sync error. If the client repeatedly rejects valid authentication, verify whether you can access the account through its official web interface.
A functioning web session and a failed desktop sign-in suggest different troubleshooting needs from an account that cannot be accessed anywhere. In the latter case, investigate account access, subscription status or organizational restrictions before replacing the synchronization software.
Microsoft’s OneDrive settings guide provides an overview of how to locate account and configuration controls on supported Windows and Mac installations.
Resume Sync And Test The Internet Connection
A client can remain paused after a deliberate pause or because the computer enters a condition that limits background transfer. Examine the status view for an available resume control. If both personal and work accounts are configured, check the one containing your affected document.
Select the resume option and observe whether the queue begins moving. Microsoft explains the supported pause controls in its pause and resume guide. Be mindful of metered mobile connections and limited data plans before resuming a large transfer.
Test the internet connection independently. Open several known public webpages and the legitimate cloud service. A local wireless connection does not guarantee useful access to online services. If the laptop cannot browse normally, solve the network issue before assuming that the OneDrive application needs repair.
Our guide to Wi-Fi connected without internet explains how to distinguish the local network from internet access. If other browsing works, a second trusted network can help establish whether the sync problem is specific to the original environment.
An organization-managed firewall, VPN or proxy may affect access to cloud services. Contact the network administrator if the symptom follows a work connection. Do not bypass required controls or permanently disable security software to make synchronization succeed.
If you can access the files online but changes fail to reach the desktop, record that discrepancy. A temporary service interruption, bandwidth limitation or client configuration can still be involved. In the meantime, avoid making competing edits to the same important file on multiple computers.
Check Cloud Storage And Local Disk Space Separately
Cloud storage capacity and the laptop’s free disk space are independent resources. A computer can have plenty of available disk space while the account cannot accept more data. Equally, an account can have substantial cloud capacity while the laptop lacks enough room to download files or perform normal temporary operations.
Open the account’s storage overview through the official OneDrive website. Check the amount used and the applicable account limit. Depending on the subscription and account configuration, some storage may be shared with other Microsoft services. Do not assume that every account has the same capacity.
On Windows, inspect Storage in System settings or use File Explorer to view available space on the relevant drive. On a Mac, consult the storage information in System Settings. Verify that you are examining the volume used by OneDrive and any location required for its normal operation.
If the cloud quota is exceeded, consider which files are genuinely unnecessary, which can be retained in an authorized independent archive, and whether more capacity is appropriate. Do not delete a shared project simply because it is large. Confirm ownership and the consequences of deletion first.
If local space is constrained, use documented storage cleanup methods and inspect each category before removing data. Files On-Demand can help reduce the amount of downloaded cloud content on a supported computer, but it is important to confirm that files are actually synchronized before making them online-only.
Our explanation of memory compared with storage can help distinguish disk capacity from system memory. Both influence the experience of using a computer, but adding memory does not increase the cloud account’s storage allowance.
Understand Files On-Demand And Folder Selection
OneDrive can display cloud-hosted files without keeping every byte on the computer. These online-only entries are useful when a device has limited local capacity, but they can cause confusion during an internet outage. The appearance of a filename does not guarantee that its contents can be opened offline.
Review the item’s status in File Explorer or Finder. An online-only file ordinarily requires access to the service when opened. A downloaded file can be usable locally, and an item explicitly retained on the device is intended to remain available when you go offline. Microsoft explains these distinctions in its documentation on working with synchronized files.
If you need a particular folder during travel, use the supported option to keep it on the device and allow the download to finish. Test the files before relying on them without a connection. Be careful about requesting an entire large library when the computer has little remaining disk space.
Folder selection is a separate issue. You may have chosen to synchronize only some account folders. Compare the missing folder with the account’s selected folders in OneDrive settings. If it exists online but has not been selected for this computer, the absence may be intentional rather than an error.
Do not confuse removing a local download with deleting the item itself. An option such as Free up space is designed to release the local downloaded copy while retaining the synchronized cloud item. Ordinary Delete is a different operation. Confirm the online copy exists and is correct before changing local availability.
Resolve Invalid File Names Paths And Unsupported Items
If most documents sync successfully but a few repeatedly fail, inspect the affected items rather than resetting the entire account. File naming restrictions, folder paths, special file types and access permissions can produce isolated failures.
Open the notification area’s sync activity and locate the specific file identified by the error. Compare its name and folder structure with Microsoft’s OneDrive and SharePoint restrictions reference. Some punctuation, reserved names and path combinations are unsuitable for synchronization. Account or organizational policy can introduce additional restrictions.
Before renaming a file, preserve its latest usable copy. Choose a short descriptive name with conventional characters and retain the appropriate extension. Do not alter the extension to disguise an unsupported file type. That can make the file difficult to open without solving the underlying policy problem.
For very deeply nested projects, consider whether a shorter folder organization is appropriate. Changes to established shared folders can affect shortcuts, links and collaborators. Obtain permission before restructuring a shared library, particularly when other people depend on existing paths.
If the error concerns permissions, verify that you can read and edit the file through the intended account and approved location. Do not grant broad system-wide permissions or take ownership of files that belong to another user. A work or school administrator can investigate the appropriate access rule.
Microsoft’s file-specific error guidance provides additional supported checks. Test an ordinary small document in the same folder after a targeted adjustment. The outcome helps separate one incompatible file from a general folder or client problem.
Investigate Processing Changes And A Stalled Queue
A long-running sync indicator does not necessarily mean the client is frozen. After a first sign-in, account reconnection or import of a large folder, the application must inspect and reconcile many items. A slow internet connection or substantial number of small files can make this work take considerable time.
Open the activity view and look for evidence that the item names, transfer progress or reported remaining workload change. Compare the behavior over a suitable interval rather than judging the client from a single status message. Record any specific file that repeatedly appears at the point where progress stops.
Close applications that are actively editing the suspected files after saving their contents. Some data formats are continuously written by other software, making them unsuitable for ordinary document synchronization under particular conditions. Consult the application’s own backup and storage guidance before moving its working data.
Microsoft discusses these possibilities in the processing changes troubleshooting article. Use its recommendations for the actual file type and environment. If you temporarily take a problematic file out of a sync queue, first preserve a verified copy and understand whether the operation could propagate a deletion.
For an isolated failure, a safer diagnostic is to create a new uniquely named copy of an ordinary editable document in an approved folder and observe its transfer. If it uploads successfully, investigate the original item and its permissions or naming conditions. If no test file transfers at all, return to the connection, account and client checks.
Avoid repeatedly restarting OneDrive while it is processing a large legitimate batch. Each interruption may require additional reconciliation. Give a progressing queue the chance to complete, provided that continuing the transfer does not exceed your network or storage constraints.
Handle Conflicting Edits And Missing Changes Carefully
A synchronization conflict may occur when a document is modified independently on two computers before the changes can be reconciled. The existence of a duplicate-looking file does not mean that one of the copies is disposable. It may contain work not present in the other version.
Stop editing the affected document until you understand which changes have been preserved. Save independent authorized copies of the relevant versions and open them separately. Compare the contents and not merely the timestamps. The most recent modification time does not always identify the version containing every required change.
For a collaborative project, coordinate with the other editors before overwriting the shared copy. Depending on the file format, application and collaboration settings, changes may be merged automatically or require manual review. A duplicated filename may have been generated to protect competing updates.
OneDrive’s version history can also help when an earlier cloud revision is available. Microsoft’s version history instructions explain how to inspect and restore stored versions. Availability and retention can depend on the account and administrative settings.
Review a version before restoring it, and preserve important current information first. A restoration changes the version that collaborators subsequently receive. Do not restore an entire account when you only need to recover one document.
If you discover that a file was actually deleted, consult the online recycle bin and any independent backups rather than creating another file with the same name. The distinction between a missing file, a failed download and overwritten content affects which recovery method is appropriate.
Unlink And Reconnect The Correct Account When Necessary
Reconnecting the account can help when simpler checks suggest an outdated or broken relationship between the local sync application and the online storage. Do not begin with this method while an important file remains unsaved or only exists as an uncertain placeholder.
First verify cloud contents through the browser and protect local-only changes according to your backup requirements. Record the current OneDrive folder location, accounts and selected folders. Ensure you can complete authentication using the approved account and any required verification method.
Open the OneDrive application’s account settings and choose the option to disconnect the affected computer from that account. Follow the platform-specific steps in Microsoft’s account reconnection guidance. On Windows and Mac, the relevant labels refer to unlinking the computer rather than deleting cloud storage.
Restart the desktop client and sign in again using the verified identity. Carefully inspect the proposed folder location. If the setup detects the existing folder, choose to reuse it only after confirming that it belongs to the same account and configuration. Do not merge unrelated personal and workplace folders.
Allow the new session to reconcile its contents before declaring the repair successful. Microsoft describes a reconnection as a temporary interruption of the local sync relationship, not a cloud-file deletion operation. However, protecting unsynced changes independently is still prudent.
If credentials need to be cleared as part of Microsoft’s documented procedure, use only the specific platform and account instructions. Do not indiscriminately delete browser passwords, system keychains or unrelated files. On a managed Mac or Windows computer, request assistance from the responsible administrator when authentication is enforced by policy.
Reset OneDrive Only After Lower-Risk Checks
Resetting the desktop client is a later-stage option when account and individual-file troubleshooting have not resolved a broader synchronization fault. It can rebuild the client’s synchronization configuration and cause considerable reconciliation afterward. Record your settings, verify important data and prepare to reconnect the affected accounts before proceeding.
For the Windows desktop sync client, Microsoft’s reset instructions list the supported Run dialog commands. The usual per-user installation can be reset by opening Run with Windows + R and using:
%localappdata%\Microsoft\OneDrive\onedrive.exe /reset
If that installation path is unavailable, consult the alternative Program Files paths in the official procedure rather than downloading a script from an unfamiliar website. After the reset, open the OneDrive desktop application from Start if it does not resume on its own.
Check that the expected account and folder choices are restored. A reset can affect more than the account you originally intended to troubleshoot, so review each configured personal or organizational connection. Avoid creating duplicate directory structures by rushing through the setup prompts.
For macOS, use the current Microsoft instructions for the installed OneDrive edition. The supported reset procedure is different from running a Windows executable. Do not paste Windows commands into the Mac Terminal or delete unknown application support directories.
If a reset is insufficient, reinstalling the sync client from a trusted Microsoft source may be considered after the existing data has been safeguarded. Microsoft’s reinstallation guide explains the supported options. Reinstallation is not a solution for every cloud quota, service, permission or file-specific restriction.
Check Work Or School Libraries And Recover Missing Files
OneDrive for work or school and synchronized SharePoint libraries can be subject to organizational limits and access policies. A document that belongs to a team may also have different ownership and recovery options from a personal OneDrive file.
If one business library fails while your personal account works, identify the exact organization and library. Check whether you can access it through the authorized website. If the library is no longer available online, contact the owner or administrator rather than creating another link to an unrelated folder.
Microsoft’s SharePoint synchronization guidance covers relevant library and client checks. Your administrator can confirm whether a specific file type, computer or account is permitted. Avoid bypassing these restrictions or moving confidential files into a personal cloud account.
For files actually deleted from OneDrive, examine its online recycle bin. Microsoft’s file recovery instructions describe the available restore locations and important limitations. Recoverability is not permanent, and local recycle bins may not contain items that existed only online.
If a widespread change affected many files, eligible accounts may offer a broader recovery operation. Review the consequences with the administrator before using it because a rollback can also affect legitimate recent changes. Recover selected files when that is sufficient.
Do not assume that repairing synchronization automatically restores deleted documents or resolves collaboration conflicts. Treat recovery as its own task, verify the intended restored contents, and retain a separate approved backup of important information where possible.
Verify Uploads Downloads And Normal Operation
A repaired client should be able to transfer new changes in both directions. Create a small, clearly named test file in the affected local folder and wait for it to appear in the web interface. Open it online and confirm that it contains the expected information rather than simply checking that the filename exists.
Then create a different harmless test file through the website in the same eligible synchronized folder. Verify that the computer receives the new entry and can open its contents, downloading them if necessary. Repeat the relevant test with the actual work folder after confirming that you are not overwriting valuable information.
Inspect the client’s status, compare any previously failing file and check that the expected accounts are connected. If the original problem involved offline availability, verify that the required local downloads have finished before intentionally disconnecting from the network.
Restore temporary diagnostic settings, remove the harmless test documents when appropriate and check that essential backups still operate. Keep a brief record of the error, account type, affected folder, platform, attempted change and final result. If problems recur, this record will help support investigate without repeating the same unsuccessful steps.
When seeking help, do not publicly share login credentials, private folder contents or full diagnostic logs containing sensitive information. Provide the necessary details through official support or your organization’s approved channels.
This article is based on Microsoft’s official documentation and structured troubleshooting reasoning. The original diagrams are conceptual rather than actual screenshots. No physical Windows or Mac computer was independently used to test this particular repair sequence.
Frequently Asked Questions
Why Are My OneDrive Files Not Syncing?
Possible causes include paused synchronization, account authentication, network problems, insufficient storage, unsupported filenames and conflicting edits. Inspect the client status and compare the exact file with its cloud copy first.
Does Resetting OneDrive Delete My Cloud Files?
Microsoft describes resetting the sync client as a configuration repair, not cloud-file deletion. Protect unsynced local changes independently and verify your accounts and folder selections afterward.
Why Are My Files Visible Online But Missing From My PC?
Check your account identity and selected folders. An online-only file may also be represented locally without its contents being downloaded.
Why Does OneDrive Keep Processing Changes?
A large reconciliation queue, recent sign-in, busy file or slow network can prolong processing. Check whether progress continues and investigate any specific recurring error.
Can I Delete The OneDrive Folder To Start Again?
Avoid deleting a synchronized folder as an initial repair. Deletions may propagate. Preserve unsynced files and use the documented account reconnection or reset procedure instead.
What If Two Copies Of A Document Have Different Contents?
Protect both versions and compare their actual edits before replacing anything. Review available version history and coordinate with collaborators.
How Do I Know OneDrive Is Syncing Again?
Test a new harmless file from the computer to the website and a different file from the website to the computer. Confirm that their contents are correct and the affected client reports normal status.



