How to Rebuild OneDrive Shortcuts After Tenant Migration

After a tenant migration, your OneDrive shortcuts to shared files and folders often break. These shortcuts point to the old tenant URL, which no longer exists. This article explains why shortcuts fail and provides step-by-step methods to rebuild them.

The root cause is that shortcuts store the target file’s original SharePoint or OneDrive URL. When your organization moves to a new Microsoft 365 tenant, all file URLs change. The old shortcut cannot resolve the new location.

You will learn how to identify broken shortcuts, remove them safely, and create new shortcuts that point to the correct tenant URLs. You will also see how to prevent this issue in future migrations.

Why OneDrive Shortcuts Break After a Tenant Migration

A OneDrive shortcut is a small file that contains a link to a file or folder stored in another user’s OneDrive or a SharePoint document library. When you create a shortcut, OneDrive downloads a .url file to your local OneDrive folder. That file stores the full web URL of the target item.

During a tenant migration, your organization moves all data from the old Microsoft 365 tenant to a new one. The old tenant URL, such as contoso.sharepoint.com, becomes inactive. The new tenant URL is something like contoso-new.sharepoint.com. Because the shortcut file still points to the old URL, it cannot find the target. The shortcut appears as a broken link with a red X in File Explorer.

OneDrive does not automatically update these shortcut URLs. There is no built-in bulk repair tool. You must manually identify and recreate each shortcut after the migration completes.

Steps to Rebuild OneDrive Shortcuts After Tenant Migration

Follow these steps in order. Do not skip Step 1, as it prevents data loss from accidental deletion.

1. Back up your existing shortcuts
   Open File Explorer and navigate to your OneDrive folder. Press Ctrl + A to select all items. Right-click and choose Copy. Paste the contents into a temporary folder on your desktop. This preserves the file names and folder structure so you know which shortcuts to rebuild.
2. Identify broken shortcuts
   In your OneDrive folder, look for files or folders with a gray icon and a white arrow badge. A red X overlay means the shortcut is broken. Sort by Type to group .url files together. Make a list of the shortcut names and their original target locations if you remember them.
3. Delete broken shortcuts from OneDrive
   Select each broken shortcut. Press the Delete key or right-click and choose Delete. Empty your OneDrive recycle bin by right-clicking the recycle bin icon in the OneDrive system tray and selecting Empty recycle bin. This step removes the bad references from your sync.
4. Navigate to the shared file in the new tenant
   Open a web browser and sign in to your new Microsoft 365 tenant at https://www.office.com. Go to OneDrive and select Shared from the left navigation. Locate the file or folder that the old shortcut pointed to. If you do not see it, ask the owner to reshare the item with your new tenant account.
5. Create a new shortcut from the correct URL
   Right-click the shared file or folder in the OneDrive web interface. Choose Add shortcut to My files. OneDrive creates a new shortcut that points to the current tenant URL. The shortcut syncs to your local OneDrive folder within a few seconds.
6. Repeat for each shortcut on your list
   Work through the list you made in Step 2. For each broken shortcut, find the shared item in the new tenant and add a new shortcut. If a shared item no longer exists, contact the owner to restore it from the recycle bin or re-upload it.

If OneDrive Shortcuts Still Show Errors After Rebuilding

Shortcut syncs but shows a red X

This usually means the target file or folder was deleted or moved after the migration. Right-click the shortcut in File Explorer and select Open in browser. If the browser shows a 404 error, the target is gone. Ask the owner to restore it or share a new link.

Shortcut does not appear in the Shared list

The file owner may not have reshared the item with your new tenant account. Request a new sharing invitation. Once you accept the invitation, the file appears in your Shared list and you can create a shortcut.

OneDrive sync is paused or stuck

A tenant migration can cause OneDrive to re-sync all files. If sync is paused, click the OneDrive cloud icon in the system tray and select Resume syncing. Wait for the sync to complete before creating new shortcuts. To check sync status, open OneDrive settings and go to Sync and backup > Manage backup.

Manual Shortcut Creation vs Automatic Shortcut Recovery: Key Differences

Item	Manual Shortcut Creation	Automatic Shortcut Recovery
Method	User navigates to shared file in new tenant and selects Add shortcut to My files	Third-party migration tool or script updates the shortcut URL
Control	Full control over which shortcuts are rebuilt	Limited control; tool may skip or miss some shortcuts
Time required	Several minutes per shortcut	Minutes for all shortcuts
Risk of error	Low if user verifies each target	Medium if tool cannot map old URLs to new ones
Requires tool installation	No	Yes
Best for	Small migrations with fewer than 50 shortcuts	Large migrations with hundreds of shortcuts

After the migration, open each shortcut in a browser to confirm it opens the correct file. If you used a third-party tool, spot-check 10 percent of the shortcuts to verify accuracy. For future migrations, document all shared file URLs before the migration starts. This list makes rebuilding shortcuts faster.

You can now rebuild broken OneDrive shortcuts after a tenant migration by backing up, deleting, and recreating them from the new tenant URL. Test each shortcut by opening it in a browser. For large migrations, consider using a third-party migration tool that supports URL remapping. To prevent future issues, keep a spreadsheet of shared file URLs and their owners before any tenant change.