OneDrive for Business file server migration troubleshooting for mergers: breaks recent links

When a company merger triggers a file server migration, users often find that their recent document links in OneDrive for Business stop working. Instead of opening the file, clicking a recent link produces a broken path error or a file not found message. This happens because the migration process changes the underlying file server path or the SharePoint URL that OneDrive uses to track recent files. This article explains why these links break during a merger-driven migration and provides specific troubleshooting steps to restore access to recently used documents.

Why Mergers Break OneDrive Recent Document Links

During a merger, the IT team typically migrates file server data from the acquired company into the parent company’s SharePoint environment. OneDrive for Business tracks recent files by storing a reference to the file’s server path or SharePoint URL. When the migration moves files to a new site collection, a different document library, or a renamed folder, the stored reference becomes invalid.

OneDrive’s recent links list is stored as a cached set of file pointers in the user’s local sync database. The sync app does not automatically update these pointers when the file’s location changes on the server. As a result, clicking a link that was added before the migration leads to a broken path. The file still exists in the new location, but OneDrive has no way to map the old reference to the new URL.

Another factor is the synchronization of Known Folder Move. If the merger migrated the user’s Desktop, Documents, or Pictures folders, the local folder redirection may point to the old SharePoint library. This mismatch causes OneDrive to lose track of recent files that were stored in those folders.

Steps to Fix Broken Recent Links After a Migration

Use the following steps in order. Each step addresses a specific cause of broken recent links. Test after each step before proceeding to the next.

Step 1: Verify the Migration Completed Without Errors

1. Open the Microsoft 365 admin center
   Go to Admin centers > SharePoint. In the left navigation, select Migration and then File server migration. Review the status of the migration job that involved the affected user’s files. Look for entries marked Failed or Partially succeeded. If the migration failed for specific files, those files may not exist in the target location at all. Re-run the migration for any failed items before proceeding.
2. Check the target document library
   In the same SharePoint admin center, navigate to the site collection where the files were migrated. Open the document library and confirm the files are present in the expected folder structure. If the folder hierarchy changed, note the new path because OneDrive will need to sync from that new path.

Step 2: Clear the OneDrive Recent Links Cache

1. Open OneDrive settings
   Right-click the OneDrive cloud icon in the system tray and select Settings. Go to the Account tab.
2. Unlink this PC
   Click Unlink this PC. Confirm the action. This removes the local sync relationship and clears the cached recent links database. Do not worry about losing local files. OneDrive will re-download the file list from the server after you re-link.
3. Re-link your account
   Close the Settings window. The OneDrive setup wizard will open automatically. Sign in with your Microsoft 365 work or school account. Follow the prompts to set up sync for the new document library that contains the migrated files. Select the folders that correspond to the new location. OneDrive will rebuild the recent links list from the server data.

Step 3: Update Known Folder Move Paths

1. Open OneDrive settings
   Right-click the OneDrive cloud icon and select Settings. Go to the Sync and backup tab.
2. Manage backup
   Click Manage backup. If the Desktop, Documents, or Pictures folders are listed with a path that points to the old SharePoint library, click Stop backup for each folder. Then click Start backup and select the new document library path. This ensures that files saved to these folders are redirected to the correct location, and recent links will point to the new path.

Step 4: Refresh the Recent List in OneDrive

1. Open OneDrive on the web
   Go to onedrive.com and sign in with your work or school account. In the left navigation, click Recent. If you see broken entries, hover over each entry and click the X to remove it. This does not delete the file. It only removes the broken link from the recent list.
2. Open a file from the new location
   Navigate to the document library that contains the migrated files. Open a file by double-clicking it. This action adds a fresh recent link to the OneDrive recent list. Repeat for a few files to repopulate the list with working links.

If OneDrive Recent Links Still Show Broken Paths

OneDrive shows the old server path in the recent list

The recent list may display the file server path from the acquired company, such as \oldserver\sharedile.docx. This happens because the migration did not update the link references in the user’s Office application MRU list. To fix this, open the file from the new SharePoint location in the Office app. Office will update the MRU list with the new URL. Close and reopen the Office app to see the updated recent files list.

OneDrive sync shows a red circle with a white minus sign

A red minus sign indicates that the file is excluded from sync. This can happen if the migration moved files into a folder that the user did not select for sync. Open OneDrive settings, go to the Account tab, click Choose folders, and select the new folder that contains the migrated files. OneDrive will then download the files and the recent links will become clickable again.

Shared links from the acquired company still work but recent links do not

Shared links generated before the migration may continue to work if the migration preserved the file’s unique ID. Recent links, however, rely on the file’s server path, which changed. If shared links work but recent links do not, the migration preserved the file but the path changed. Follow Step 2 to unlink and re-link OneDrive to force the recent list to use the new path.

Files On-Demand vs Always Keep on This Device: Impact on Recent Links After Migration

Item	Files On-Demand	Always Keep on This Device
How recent links are stored	Stored as online-only pointers in the local sync database	Stored as local file paths with a sync marker
Behavior after migration	Link breaks because the online pointer references the old URL	Link breaks because the local path no longer matches the server path
Fix method	Unlink and re-link OneDrive to refresh online pointers	Unlink and re-link OneDrive, then change folder to Always Keep on This Device

After the migration, both modes require a fresh sync relationship to rebuild the recent links. The difference is that Files On-Demand will re-create online-only pointers, while Always Keep on This Device will download the files again. Choose the mode that matches your storage preference and network bandwidth.

You can now restore broken recent links after a merger-driven file server migration by unlinking and re-linking OneDrive, updating Known Folder Move paths, and clearing stale entries from the recent list. Next, verify that all users in the acquired company have completed these steps to avoid repeated support tickets. As an advanced tip, use the SharePoint Migration Tool’s built-in link fixup feature before the migration to automatically rewrite file references in Office documents, which reduces the number of broken links users experience.