Troubleshoot a SharePoint Online file migration (beta)

Here’s how to address common issues you might encounter when setting up a file migration and migrating data.

• Can't start a migration
• Need permission to access resources error
• User account issues
• Error uploading migration file for sites & site collections
• Migration completes with failed items
• Missing files, folders, or permissions

Can't start a migration

If you get a To start migration, you must have super admin privileges and complete all previous steps error, make sure that a super administrator for your Google Workspace account starts the migration. Learn more

Need permission to access resources error

If you get a Needs permission to access resources in your organization that only an admin can grant error, make sure that you're using a valid Global Administrator account to connect to the Microsoft account. For details, go to Migrate files from a SharePoint Online account (beta).

User account issues

Before you begin a migration, you have to set up the user accounts in Google Workspace. For details on setting up user accounts, go to Options for adding users.

A user account that is not set up or set up incorrectly, can cause the following issues in the reports:

Error uploading migration file for sites & site collections

When you upload the file for your sites and site collections, you might get one of the following errors:

• Upload sensitive CSV failed.
• Validate CSV failed.
• Bulk action initiation failed.
• Your CSV includes duplicate sites. Check for duplicates, including subsites listed with their parent sites, then try again.
• Your CSV has too many site URLs. Update it to include 100 or fewer and try again.

To troubleshoot, confirm the following items are correct and then upload the file again:

• The file has the right header names: Source SharePoint URL, Target Drive FolderID, Target GUser.
• The file contains rows other than the headers and each row is filled with all mandatory values.
• Each SharePoint Online site URL is only listed once.
• No more than 100 SharePoint Online site URLs are in the file.
• The file has parent sites or subsites in the parent site, but not both.

Migration completes with failed items

1. Click Export Migration report.
2. Identify items that didn't migrate and the reasons for their failure. For details, go to Understand a SharePoint Online migration report (beta).
3. Fix the issues and then run a delta migration for SharePoint Online.

Missing files, folders, or permissions

If you have a missing files, folders, or permissions after a migration, follow these steps:

1. Make sure the sites and site collections file includes the correct URLs for the SharePoint Online sites of the missing items. Learn more about how to create a file for the sites & site collections to migrate.
2. Verify that your identity map contains the correct list of users. For details, go to Create an identity map from SharePoint Online to Workspace.
3. Make sure that at least one owner of the source file or folder has a user account in Workspace.
4. Export the migration report. For details, go to Access the Report.
5. In the report, search for the missing file using the file name. File names are part of the Source URL in the migration report.
6. If the error message shows as failed in the report, locate the error code in Understand a SharePoint Online migration report (beta). Then, follow the instructions to troubleshoot the error message.
7. Run a delta migration.