Reset OneDrive Sync for One SharePoint Site: Practical Checklist for SharePoint Owners
🔍 WiseChecker

Reset OneDrive Sync for One SharePoint Site: Practical Checklist for SharePoint Owners

As a SharePoint site owner, you may find that OneDrive sync stops working, shows errors, or behaves unexpectedly for a single site. This often happens after a site rename, a permission change, or a corrupted local sync cache. Resetting sync for that specific site without affecting other synced sites requires a targeted approach. This article provides a practical checklist to safely reset OneDrive sync for one SharePoint site, explaining each step and the underlying reason.

Key Takeaways: Reset OneDrive Sync for One SharePoint Site

  • OneDrive Settings > Account > Stop sync: Removes the site link from your local OneDrive without deleting files.
  • File Explorer > OneDrive icon > Manage sync: Lets you select which folders sync for this site after resetting.
  • OneDrive Web > Sync button: Re-establishes sync from the SharePoint site to your computer.

ADVERTISEMENT

Why OneDrive Sync Breaks for a Single SharePoint Site

OneDrive sync uses a local cache stored in your user profile folder. When you sync a SharePoint document library, OneDrive creates a mapping between the library URL and a local folder. If the site URL changes, permissions are modified, or the cache becomes corrupted, this mapping fails. The result is sync errors that affect only that site while other synced sites work fine.

A site rename in SharePoint changes the URL. OneDrive still points to the old URL, causing a sync failure. Permission changes can also break sync because OneDrive re-authenticates and may fail if the token is outdated. A corrupted cache happens when files are modified outside of OneDrive, such as moving or deleting files directly in the local folder.

The fix is to remove the broken mapping and recreate it. This checklist walks you through that process without affecting other synced sites.

Checklist to Reset OneDrive Sync for One SharePoint Site

  1. Stop Sync for the Problematic Site
    Open OneDrive settings by right-clicking the OneDrive cloud icon in the system tray and selecting Settings. Go to the Account tab. Under the list of synced sites, find the SharePoint site that is not working. Click Stop sync next to that site. Confirm the dialog. This removes the local folder mapping but does not delete your files from the cloud or your computer.
  2. Delete the Local Sync Folder (Optional but Recommended)
    Navigate to the local folder that was syncing this site. By default, it is located under C:\Users\[YourUsername]\[SiteName]. Delete this folder. If you have made changes to files that are not yet synced, copy them to a safe location first. Deleting the folder ensures a clean start and removes any corrupted cache files.
  3. Clear the OneDrive Cache for This Site
    Press Windows key + R, type %localappdata%\Microsoft\OneDrive\settings\Business1, and press Enter. Look for a file named ClientPolicy_dat or a folder named after your site. Delete only the files or folders that match the problematic site. This step removes cached settings that may conflict with the new sync.
  4. Re-sync the SharePoint Site from the Web
    Open a web browser and go to the SharePoint site. Navigate to the document library you want to sync. Click the Sync button in the toolbar. OneDrive will prompt you to sign in if needed. Choose the folders you want to sync and click Start sync. OneDrive recreates the mapping and downloads the files.
  5. Verify Sync Status
    Check the OneDrive icon in the system tray. It should show a green checkmark. Open File Explorer and navigate to the newly created folder. Confirm that files are appearing and that changes sync both ways. Right-click a file and check the OneDrive sync status column.

ADVERTISEMENT

If the Sync Still Does Not Work After Reset

OneDrive Shows an Error for the Site After Re-sync

If you still see errors after re-syncing, the site may have a broken URL mapping in the OneDrive database. Run the OneDrive diagnostic tool. Right-click the OneDrive icon, select Settings, go to the About tab, and click the OneDrive icon with the gear. Choose Diagnostics. This tool checks for sync issues and can repair the mapping. If that fails, unlink and relink your account from OneDrive Settings > Account > Unlink this PC. After unlinking, repeat steps 1 through 5.

OneDrive Sync Shows Files as Read-Only

This usually means the SharePoint library has check-out requirements or permission changes. Go to the SharePoint site in a browser. Open the library settings and check if Require Check Out is enabled. If so, users must check out files to edit them. Also verify that the user has at least Contribute permissions on the library. If permissions changed while sync was active, the local cache may still hold old permissions. Resetting sync as described above clears the cached permissions.

OneDrive Sync Stops After Moving a Folder Inside the Synced Library

Moving folders within a synced library can confuse OneDrive if the move is done outside of OneDrive, such as using Windows Explorer. The sync engine sees the folder at a new path and may try to re-download everything. To fix this, stop sync for the site using step 1, then delete the local folder (step 2), and re-sync (step 4). Moving folders inside the OneDrive folder in File Explorer is safe as long as OneDrive is running.

Item Stop Sync Only Full Reset (Stop + Delete + Cache Clear)
Time required 2 minutes 10 minutes
Files deleted locally No Yes (if you delete the folder)
Cache cleared No Yes
Best for Minor sync errors or testing Corrupted cache, URL changes, permission issues

Use the Stop Sync Only method when you just need to re-sync after a simple error like a temporary network glitch. Use the Full Reset method when the site was renamed, permissions were changed, or you see persistent errors like “This folder is no longer synced”.

Conclusion

You can now reset OneDrive sync for a single SharePoint site using the checklist provided. Start by stopping sync for that site in OneDrive Settings, then delete the local folder and clear the cache if needed. Re-sync the site from the SharePoint web interface to restore proper file syncing. For persistent issues, use the OneDrive diagnostic tool or unlink your account. Always test with a single file after re-syncing to confirm the connection works before restoring large amounts of data.

ADVERTISEMENT