When you rename a SharePoint site or a Microsoft 365 group that hosts a shared library, OneDrive sync for that library often stops working. The sync client loses the connection to the original site URL and cannot find the new path. This results in sync errors, red X icons, and files that appear as unsynced placeholders. This article explains why the rename breaks sync and provides the exact steps to restore it without losing local data.
Key Takeaways: Restoring OneDrive Sync After a SharePoint Site Rename
- OneDrive sync status icon in the system tray: Right-click to open the sync client and identify the library showing an error after the rename.
- OneDrive Settings > Account > Stop sync: Use this option to disconnect the broken library before reconnecting it to the new site URL.
- SharePoint site URL in the browser address bar: Copy the new site URL after the rename and paste it into the OneDrive Add shortcut dialog.
Why Renaming a Site Breaks OneDrive Sync
OneDrive for Business uses the site’s URL as a unique identifier to maintain the sync relationship. When you rename a SharePoint site or a Microsoft 365 group, the URL changes. The sync client stores the old URL in its configuration. After the rename, the client sends requests to the old URL, which no longer exists. The server returns a 404 error or a redirect that the sync client cannot follow automatically. This causes the sync to stop, display a red X, or show a “Sync is paused” message.
The rename itself can happen in several ways. A SharePoint site administrator changes the site name in the SharePoint admin center or in the site settings. A Microsoft 365 group owner renames the group in the Microsoft 365 admin center. Both actions change the underlying site URL. OneDrive sync does not receive a notification of this change. It continues to point to the old URL until you manually stop and restart the sync.
What Happens to Local Files During the Break
Local files that were synced before the rename remain on your computer in the original folder. They are not deleted. However, the sync client marks them as unsynced because it cannot reach the server. You can still open and edit these files locally. Changes you make will not upload to the renamed site until you reconnect the library. This means your local files are safe, but they are not backed up to the cloud during the gap.
Steps to Restore OneDrive Sync After a Site Rename
Follow these steps in order. Do not delete local files or uninstall OneDrive. The fix requires stopping the broken sync connection and reconnecting to the new site URL.
- Open OneDrive Settings
Right-click the OneDrive cloud icon in the system tray near the clock. Select Settings from the menu. In the window that opens, go to the Account tab. - Identify the broken library
Under the Account tab, look at the list of synced folders. Find the library that belonged to the renamed site. It may show an error icon, a red X, or the old site name. Make a note of the local folder path for this library if you want to keep the existing files in place. - Stop sync for the broken library
Click the three dots or the overflow menu next to the broken library. Select Stop sync. A confirmation dialog appears. Read the warning that local files will remain but will no longer sync. Click Stop sync to confirm. The library disappears from the synced list. Do not delete the local folder. - Get the new site URL
Open a web browser and navigate to the renamed SharePoint site. If you do not know the new URL, ask your site administrator or search for the site in the SharePoint app launcher. Copy the full URL from the browser address bar. The URL should end with a path like /sites/newname or /teams/newname. - Add the library back to OneDrive sync
In the OneDrive Settings window, still on the Account tab, click Add a shortcut or Add a folder. A dialog opens. Paste the new site URL into the text box. Click Next. OneDrive will connect to the site and show the available document libraries. Select the library you want to sync. Click Sync. - Choose the local sync location
OneDrive asks you to confirm the local folder path. By default, it creates a new folder under your OneDrive directory. To use the existing local folder from the old sync, click Change location and browse to that folder. Select it and click Choose folder. Click Start sync. OneDrive will compare the local files with the server and begin syncing. - Verify sync status
Wait for the initial sync to complete. Check the OneDrive icon in the system tray. It should show a solid white or blue cloud with no errors. Open the local folder and confirm that files are syncing. Right-click a file and look for a green check mark or a syncing icon.
Alternative Method: Remove and Re-add the Site in OneDrive
If the Stop sync option does not appear or the library refuses to disconnect, you can remove the site from OneDrive entirely. Open OneDrive Settings > Account. Under the synced folders list, click the three dots for the problematic library and select Remove shortcut. This removes the link from OneDrive without deleting local files. Then follow steps 4 through 7 above to re-add the library using the new URL.
If OneDrive Still Has Issues After the Main Fix
OneDrive Shows “This folder is no longer synced”
This message appears when OneDrive detects that the original site URL is no longer valid. It may appear even after you have reconnected the library. To resolve this, restart OneDrive. Right-click the OneDrive icon in the system tray and select Close OneDrive. Wait 10 seconds. Open OneDrive from the Start menu. The reconnected library should show as active. If the message persists, repeat the steps in the main fix and ensure you selected the correct new URL.
Local Files Are Missing After Reconnecting
This happens if you chose a different local folder during reconnection instead of the existing one. Your original files are still on the drive in the old folder. Navigate to the old folder using File Explorer. Copy the files to the new sync folder. OneDrive will upload them and merge with any server files. To prevent this in the future, always use the Change location option in step 6 to point to the existing folder.
Sync Conflicts Appear for Every File
When you reconnect a library after a rename, OneDrive may detect differences between your local files and the server files. This can cause sync conflicts with names like “File (1).docx” or “File (conflicted copy).docx”. To resolve, open the OneDrive sync center by clicking the cloud icon and selecting View sync conflicts. Review each conflict and choose the correct version to keep. After resolving all conflicts, future syncs will run normally.
Stop Sync vs Remove Shortcut vs Unlink PC: Key Differences
| Item | Stop Sync | Remove Shortcut | Unlink PC |
|---|---|---|---|
| Description | Disconnects a single library from sync | Removes the library from the synced list | Disconnects all OneDrive sync on the computer |
| Effect on local files | Files remain in the local folder | Files remain in the local folder | Files remain but the entire OneDrive sync relationship is removed |
| When to use | When only one library is broken after a rename | When Stop Sync is not available or fails | When multiple libraries are broken or the entire OneDrive account needs a fresh start |
| Reconnection | Re-add the library using the new URL | Re-add the library using the new URL | Sign in again and re-sync all libraries |
For a single renamed site, use Stop Sync or Remove Shortcut. Unlink PC is a heavier action that should be used only when the entire OneDrive client is corrupted or when you are setting up a new computer.
Conclusion
You can now restore OneDrive sync for a shared library after a SharePoint site rename by stopping the old sync and reconnecting with the new site URL. Always keep the local folder path when reconnecting to avoid file loss. For future site renames, notify users in advance and provide the new URL so they can reconnect quickly. As an advanced tip, use the OneDrive admin center to pre-configure known folder move policies that automatically redirect sync paths when sites change.