OneDrive for Business file server migration breaks recent links for finance folders: Fix Guide

You migrated a file server folder to OneDrive for Business, but now the finance team reports that all recent document links in chat, email, and shared lists point to the old network path. Instead of opening the file, users see a file not found error or a broken shortcut. This happens because OneDrive sync replaces the server path with a local OneDrive folder path, but the URL-based links that point to the original UNC path remain unchanged. This article explains why the links break and provides a step-by-step fix to redirect or replace those links so the finance team can access files without re-sharing every link.

Why File Server Migration Breaks Recent Links in Finance Folders

When you migrate a finance folder from a file server to OneDrive for Business, the underlying storage location changes from a UNC path like \\fileserver\finance\Q4_Reports to a OneDrive sync path such as C:\Users\username\OneDrive - Contoso\Finance\Q4_Reports. Any link that was created before the migration — whether pasted in a Teams chat, embedded in an email, or saved in a shared list — still points to the old server path. Users who click that link see an error because the server path no longer exists.

OneDrive sync does not retroactively update existing links. The migration process copies files and folders but does not rewrite link references in documents, emails, or chat history. The finance team experiences this most acutely because they rely on shared links to quarterly reports, budget spreadsheets, and audit files that are frequently referenced across the organization.

The root cause is a mismatch between the old UNC path and the new OneDrive URL. OneDrive uses a web-based URL format: https://contoso-my.sharepoint.com/personal/username/Documents/Finance/Q4_Reports. No automatic redirect exists for UNC-to-OneDrive path changes unless you configure link redirection during the migration.

Steps to Fix Broken Recent Links After a OneDrive File Server Migration

1. Identify all affected finance folder paths
   List the exact UNC paths that were migrated. For example: \\fileserver\finance\Q4_Reports. Note the new OneDrive sync folder path for each. Open File Explorer and navigate to C:\Users\[YourUsername]\OneDrive - Contoso\Finance to confirm the folder structure matches.
2. Enable link redirection in SharePoint Migration Tool
   If you are still in the migration window, use the SharePoint Migration Tool SPMT from Microsoft. In SPMT, select the finance folder and check the option Preserve file share permissions and link redirection. This creates a redirect rule that maps the old UNC path to the new OneDrive URL. The redirect works only for users who have the OneDrive sync client installed and are signed in.
3. Use OneDrive admin center to set up path mapping
   Go to the Microsoft 365 admin center. Select OneDrive admin center > Sync > Known Folder Move. Add the finance folder path as a managed folder. This forces the OneDrive sync client to map the old server folder to the OneDrive folder and applies a redirect for any links that reference the old path. The redirect lasts for 30 days by default and can be extended up to 90 days in the SharePoint admin center.
4. Test a broken link with the redirect active
   Ask a finance team member to click a known broken link from a Teams chat or email. The link should now open in the browser or in the OneDrive sync folder. If it still fails, verify the redirect rule: in SharePoint admin center, go to Migration > Redirect rules and confirm the rule for \\fileserver\finance is set to Active.
5. Manually replace high-priority links if redirect is not available
   For links that must work immediately and cannot wait for redirect propagation, manually replace the link. Open the document in OneDrive in a browser, click the Share button, and copy the new link. Paste it into the chat, email, or document where the old link was used. Focus on the top 10 most-referenced finance files first: budget templates, monthly close reports, and audit trails.
6. Communicate the new folder structure to the finance team
   Send a notice to all finance users explaining that the server path \\fileserver\finance is now OneDrive - Contoso\Finance. Include the new link format: https://contoso-my.sharepoint.com/personal/username/Documents/Finance. Instruct them to re-share any file that they frequently link to from email or Teams. This reduces future link breakage.

If Recent Links Still Break After the Migration Fix

OneDrive sync shows a red circle with a minus sign on the finance folder

This means the folder is not syncing. Open OneDrive settings, select Sync and backup > Manage backup, and confirm the finance folder is listed. If it is missing, click Add folder and navigate to the OneDrive location. After adding, wait for sync to complete. Broken links will not work until the folder is fully synced.

Users get a permission denied error when clicking the new link

The finance folder may have inherited new permissions from OneDrive that differ from the original file server permissions. In the OneDrive admin center, go to Sharing and verify that the finance folder permissions are set to Specific people with the correct user list. Reapply the original NTFS permissions using the SharePoint Migration Tool if needed.

Link redirect works for some users but not others

Redirect rules apply per user based on their OneDrive sync client version. Ensure all finance users have OneDrive sync client version 22.022 or later. Go to OneDrive settings > About to check the version. If a user is on an older version, update from the Microsoft 365 admin center under Software downloads > OneDrive.

Link Redirection vs Manual Link Replacement: Key Differences

Item	Link Redirection	Manual Link Replacement
Setup effort	Requires SPMT or SharePoint admin configuration	Requires individual editing of each link
Scope	Applies to all links pointing to the migrated UNC path	Applies only to the links you manually update
Duration	30 to 90 days after migration	Permanent after replacement
User experience	Transparent — users click the old link and are redirected	Users must be given the new link
Best for	Large migrations with many links to finance folders	Critical links that need immediate fixing

After completing the migration fix, the finance team can access their files through both old and new links for up to 90 days. Test the redirect by clicking a link from a shared email or Teams message. For long-term stability, update the most important links manually and train the team to always share files using the OneDrive Share button rather than copying a file server path. The OneDrive admin center provides a migration dashboard under Migration > Review progress where you can monitor redirect rule usage and identify any remaining broken links.