OneDrive for Business file server migration troubleshooting for remote users: breaks recent links

Remote users who access files through OneDrive for Business after a file server migration often find that their recent file links no longer work. Clicking a link from Microsoft 365 apps, email attachments, or shared shortcuts returns errors like “file not found” or “access denied.” This happens because the underlying file paths change during migration while the user’s local cache and file references remain tied to the old server location. This article explains why those links break, how to restore access for remote users, and which settings prevent the problem from recurring.

Why File Server Migration Breaks Recent Links for Remote Users

When a file server is migrated to OneDrive for Business, each file receives a new unique URL in the SharePoint Online or OneDrive backend. Local shortcuts, email attachments, and Microsoft 365 app links that pointed to the old server path (for example, \\fileserver\shared\report.docx) no longer resolve. Remote users who work outside the corporate network are hit hardest because they rely on these links to open files from anywhere. The migration tool moves the files but does not update the links stored in user profiles, browser history, or Office Recent Documents lists.

Three technical factors cause the breakage:

Path Translation in OneDrive Sync

OneDrive sync uses a local folder structure that mirrors the cloud. If the migration copies files into a new folder hierarchy, the local sync path changes. Remote users who have not re-synced the new structure see broken shortcuts because the old path no longer exists on their device.

Office Recent Documents Cache

Microsoft 365 apps store a list of recently opened files using the original file URL. When the file moves to OneDrive, the app cannot find the old URL. The user sees a broken link in the Recent list inside Word, Excel, or PowerPoint.

Shared Link Expiration and Permissions

File server migrations often change permission inheritance. If the migration tool does not preserve share permissions, previously shared links may fail for remote users who are not re-added to the new folder. OneDrive shared links have expiration settings that can also invalidate older links.

Steps to Restore Broken Recent Links After Migration

Follow these steps in order. Each step addresses one layer of the link breakage.

1. Re-sync the migrated folder structure
   On the remote user’s device, open OneDrive settings by clicking the OneDrive cloud icon in the system tray and selecting Help & Settings > Settings. Go to the Account tab and click Choose folders. Uncheck the old migrated folder and click OK. Then repeat the process and re-check the folder. This forces OneDrive to rebuild the local sync tree with the correct paths.
2. Clear and rebuild the Office Recent Documents cache
   Close all Office apps. Press Windows + R, type %APPDATA%\Microsoft\Office\Recent, and press Enter. Delete all files in this folder. When the user next opens Word, Excel, or PowerPoint, the Recent list will be empty. The apps will repopulate it with working OneDrive links when the user opens files from the new location.
3. Update shared links with new OneDrive URLs
   In a web browser, sign in to the OneDrive or SharePoint site that contains the migrated files. Select the file or folder, click Share, and then click Copy link. Send the new link to all remote users who had access to the old file server path. To prevent link expiration, set the link permission to People in your organization or Specific people and choose Never expire.
4. Enable Known Folder Move for remote users
   In the Microsoft 365 admin center, go to Settings > OneDrive > Sync. Under Known Folder Move, enable Automatically move known folders to OneDrive. This redirects Desktop, Documents, and Pictures folders to OneDrive. Any local shortcuts that referenced files in those folders will now point to the correct OneDrive path.
5. Rename the SharePoint site URL if needed
   If the migration created a new SharePoint site collection with a different URL, go to the SharePoint Admin Center, select the site, and click Settings > Site URL rename. Enter the old server path as the new URL. This preserves any links that still contain the old site name.

If OneDrive Links Still Break After Migration

OneDrive sync shows “We can’t sync these files”

This error occurs when the migration copied files with names or characters that OneDrive does not support. Common blockers include file names longer than 400 characters, trailing periods, or invalid characters like \ / : ? " < > |. Use the OneDrive web interface to rename or move the problematic files. Then re-sync the folder on the remote user’s device.

Remote users cannot open shared links from email

If the shared link in an email still points to the old file server URL, the recipient sees a 404 error. Ask the sender to reshare the file using the new OneDrive link. To automate this for large migrations, use the SharePoint Migration Tool (SPMT) with the option Preserve file share permissions enabled. This option maps old server paths to new OneDrive URLs in the migration log, making it easier to identify broken links.

Office apps crash when clicking Recent items

This happens when the Office Recent cache contains a mix of old and new file URLs. Perform the cache clearing step from the main fix. If the issue persists, run the Office Repair tool: open Control Panel > Programs and Features, select Microsoft 365 Apps, click Change, and choose Quick Repair. After the repair, restart the computer.

Direct Sync vs Known Folder Move: Key Differences for Remote Users

Item	Direct Sync	Known Folder Move
Description	User manually selects which OneDrive folders to sync to their device	Automatically redirects Desktop, Documents, and Pictures to OneDrive
Link behavior after migration	Old shortcuts remain broken until user re-syncs the new folder	Local shortcuts in known folders are updated automatically
Remote user setup	Requires user to open OneDrive settings and choose folders	Admin enables via Microsoft 365 admin center, user accepts prompt
Impact on recent links	Does not fix Office Recent cache or shared links	Only fixes links in known folders, not email or external shared links

For remote users, Known Folder Move is the faster option because it requires no manual folder selection. However, it does not repair shared links or the Office Recent cache. You must still perform the cache clearing and link resharing steps for a complete fix.

After completing these steps, remote users can open migrated files from their Recent lists, email attachments, and shared shortcuts without errors. Next, review your migration plan to include a link audit phase that checks every shared file before the cutover date. As an advanced tip, use the SharePoint Migration Tool with the ‑‑PreserveFileSharePermissions flag to generate a CSV mapping file that lists every old path and its new OneDrive URL, which you can use to update links in bulk using PowerShell.