After moving files to OneDrive for Business, you need a structured plan to verify everything is in order. Many users assume migration success means all files are present, but missing sync rules, incorrect permissions, or broken shortcuts can cause data loss. This article explains how to build a post-migration checklist in OneDrive for Business. You will learn which settings to check, how to validate file access, and how to confirm sync behavior before removing source files.
Key Takeaways: Build Your OneDrive Post-Migration Checklist
- OneDrive sync app > Settings > Account > Choose folders: Select which folders sync to each device and confirm the correct library is connected.
- OneDrive web > My files > Share > Manage access: Verify that migrated files retain the correct sharing links and permissions.
- OneDrive web > Settings > Office apps > Files On-Demand: Enable Files On-Demand to save local disk space while keeping files accessible.
What a Post-Migration Checklist Covers
A post-migration checklist is a sequence of verification steps you run after moving files into OneDrive for Business. The checklist confirms that all files transferred without corruption, that permissions are correct, and that sync behavior matches user expectations. Without a checklist, you risk leaving behind orphaned files, broken shortcuts, or sync conflicts that only surface when a user tries to open a document weeks later.
The checklist has four main areas: file integrity, permissions and sharing, sync configuration, and cleanup of source locations. Each area contains specific checks that you can repeat for every user or department. You should run these checks immediately after migration and again one week later to catch delayed issues like sync errors or missing metadata.
Prerequisites
Before you start the checklist, ensure the following are in place:
- All users have the OneDrive sync app installed and signed in with their work or school account.
- Migration tool logs show zero errors for file transfer failures.
- Users have been notified that their files are now in OneDrive and that local shortcuts may need updating.
Steps to Build and Run Your Post-Migration Checklist
Follow these steps to create a reusable checklist that covers every critical area. Perform each check on the OneDrive web app at https://onedrive.live.com or in the sync app on Windows.
- Verify file count and total size
Open OneDrive in a browser. Navigate to My files. Scroll to the bottom of the page and note the file count and total size shown in the status bar. Compare this to the pre-migration file count from your source location. A mismatch of more than 1 percent indicates missing files or duplicates. - Check for corrupt or unreadable files
In My files, select a random sample of 20 files from different folders. Open each file directly in the browser. If any file fails to open or shows garbled content, restore it from the migration tool backup or re-upload the original. - Validate sharing links and permissions
For each shared folder, right-click the folder and select Manage access. Confirm that the correct people or groups appear. If a shared link was set to Anyone with the link, verify that it still works by opening the link in a private browser window. - Enable Files On-Demand on all devices
In the OneDrive sync app, go to Settings > Sync and backup > Advanced settings. Under Files On-Demand, select Save space and download files as you use them. This prevents the sync app from downloading every migrated file to the local hard drive. - Select which folders sync to each device
In the sync app, click the OneDrive icon in the notification area. Select Settings > Account > Choose folders. Clear the checkboxes for folders that the user does not need on that specific device. This reduces sync traffic and local storage use. - Test file sync by creating a new document
Create a new Word document in a synced folder. Save it and wait 30 seconds. Open OneDrive in a browser and confirm the new file appears. If it does not appear, restart the sync app and check the sync status icon in the notification area. - Update shortcuts and mapped drives
If users had mapped drives pointing to the old file server location, remove those mappings. Replace them with a shortcut to the OneDrive folder. On Windows, right-click the OneDrive folder in File Explorer and select Pin to Quick access for frequent use. - Clean up the source location
After all checks pass, move the source files to a backup archive or delete them if no retention policy requires them. Do not delete the source until at least two weeks have passed without any sync errors.
Common Post-Migration Issues and How to Avoid Them
Migrated files show as online-only but cannot be opened
This happens when the sync app has not fully downloaded the file metadata. Right-click the file in File Explorer and select Always keep on this device. Wait for the green checkmark to appear, then open the file. If the issue persists, sign out of the sync app and sign back in.
Sharing links from the old location no longer work
Migration tools do not automatically transfer external sharing links. You must re-create any links that were set to Anyone with the link or People in your organization. To do this, right-click the file in OneDrive web, select Share, and configure the link type again. Send the new link to all recipients.
File names exceed the 255-character OneDrive path limit
OneDrive for Business has a maximum path length of 400 characters, but the sync app on Windows has a 255-character limit for individual file names and folder paths. If a file fails to sync, check its path length. Rename folders or files to shorten the path to under 255 characters.
Known Folder Move redirects desktop, documents, and pictures incorrectly
If you used Known Folder Move during migration, verify that the folders are redirected to the correct OneDrive account. Open the sync app settings, go to Backup, and confirm that Desktop, Documents, and Pictures show Protected. If any folder shows Not protected, click Manage backup and re-select the folder.
Post-Migration Checklist vs Migration Tool Logs: Key Differences
| Item | Post-Migration Checklist | Migration Tool Logs |
|---|---|---|
| Description | Manual user-side verification of file integrity, permissions, and sync behavior | Automated report of transfer success, errors, and skipped items from the migration tool |
| Scope | End-user experience, sharing links, sync app configuration | File transfer statistics, folder mapping, and error codes |
| Timing | Immediately after migration and again after one week | Generated during and immediately after the migration process |
| Data checked | File openability, permission accuracy, sync status, shortcut validity | File count, size, transfer speed, error count, retry attempts |
Both the checklist and the logs are necessary. The logs confirm that the migration tool ran without errors, while the checklist validates that the end result works for the user. Relying on logs alone misses problems like broken sharing links or incorrect sync folder selection.
After you complete the checklist, you can confidently remove the old file server location. Run the checklist again for any new user who joins after migration. For advanced users, create a PowerShell script using the Microsoft Graph API to automate file count verification and permission checks across multiple OneDrive accounts. This saves time when managing migrations for more than 50 users.