File migration copies files and other related data from your Microsoft OneDrive business editions to your organization’s Google Workspace users’ My Drive accounts. Except where indicated, perform the following steps in the Google Admin console of your target Google Workspace account (the account you're migrating to).
You must be signed in as a super administrator for this task.
Expand section | Collapse all & go to top
-
Sign in with a super administrator account to the Google Admin console.
If you aren’t using a super administrator account, you can’t complete these steps.
- For Microsoft OneDrive, click Migrate.
- Click Connect to Microsoft OneDrive and sign in as a Global Administrator with your Microsoft account. If you can’t connect, make sure you're using a Global Administrator account to sign in to Microsoft.
The new data migration service transfers files, folders, and permissions from a list of Microsoft OneDrive source users to target Google Workspace users. You can create a comma-separated values (CSV) file for the list, or you can update an existing file to match the required formatting.
To get details about users in your One Drive tenant, go to Manage Microsoft 365 user accounts.
Tip: Click Download sample CSV file to get an example file you can use.
If you're creating your own file:
- Open a spreadsheet program.
- In the first column, add the header Source OneDrive User.
- On separate rows, add the emails of Microsoft OneDrive users that you want to migrate. You can migrate up to 100 users at a time. Additional users will require a separate migration.
- Save the spreadsheet as a CSV file.
Note: The file must be smaller than 10 MB.
Example:
| Source OneDrive User |
| [email protected] |
| [email protected] |
- Upload the file:
- In your Admin console, click Upload CSV.
- Select your CSV mapping file
click Open.
- Click Tasks
to confirm that the mapping file is successfully uploaded.
Note: If the CSV file doesn't load successfully, go to (Optional) Step 3: Delete a CSV file. If you encounter this issue more than once, contact Google Workspace support.
If there is an error during the CSV upload or the upload gets stuck, you can delete the current configuration and upload a new one.
- Select the CSV file you want to remove.
- Click Delete
.
- Click Yes to confirm that you want to delete the CSV file.
- To upload a new migration map for teams, go to Step 2: Set migration scope. To upload a new identity map, go to Step 4: Create and upload an identity map.
This step is optional if the Unmapped identities setting is turned on.
You use an identity map to connect users on the source account to users on the target account. To get details about users in your One Drive tenant, go to Manage Microsoft 365 user accounts. You can also download a list of your organization’s Google Workspace users.
Tip: Click Download sample CSV to get an example CSV file that you can use.
- Open a spreadsheet program.
- In the first column, add the header Source Email.
- In the second column, add the header Destination Email.
- Using valid email addresses, add your organization’s Microsoft OneDrive source accounts and their target accounts in Google Workspace.
- Save the spreadsheet as a CSV file.
Note: The CSV file must be smaller than 10 MB.
Example:
| Source Email | Destination Email |
| [email protected] | [email protected] |
| [email protected] | [email protected] |
- Upload the file
- In your Admin console, click Upload CSV.
- Select your CSV mapping file
- Click Tasks
Notes:
- External users do not need to be added to the identity map. Their permissions are migrated by default.
- If the CSV file doesn't load successfully, go to (Optional) Step 3: Delete a CSV file. If you encounter this issue more than once, contact Google Workspace support.
You can use settings to filter the files you want to remove from the scope of migration. You can set a date range to migrate only files created or modified after a certain date. You can also exclude files with specific extensions. Finally, you can choose to migrate only files that are smaller than a certain size. These settings help you manage your migration and ensure that you only move the files you need.
The map all users setting is enabled by default, along with the Keep the source domain option. As an administrator, you can disable these settings by unchecking them and then clicking Save.
- To map all users, including those not found in the identity map, ensure that the Copy accounts that aren't included in the map that are discovered during the migration box is checked. Choose an option:
- If the user's email address on the source account is the same as their address in Google Workspace, ensure that Keep the source domain is selected.
- If the domain name for all migrated users is changing, select Select a different domain for the migration and then select a domain.
This setting applies only to users that belong to the customer. External users are mapped to themselves unless you provide a different mapping in the identity map. To learn more, go to Step 4: Create and upload an identity map.
The date range filter applies only to individual files, not folders. All folders will migrate, whether or not they contain files that meet the date range criteria.
- To filter files by date, check the Date range box and then select an option:
- To filter files by their creation date, select Created by and then select a date.
- To filter files by the date of their last update, select Modified by and then enter a date.
The new data migration service migrates files from the selected date to the date that you start the migration. Dates are based on your local timezone.
- If you don't want to migrate all file types, check the Exclude specific file formats box, and then enter the file extensions you want to exclude. Separate different file extensions with a comma, for example, tmp, log, bak.
- If you don't want to migrate larger files, check the Exclude files larger than box, enter a maximum size, and then select Mb or Gb.
- Click Save.
- Click Start migration.
Note: This action grants domain-wide delegation and creates a client ID for Data migration (New) in the target account. For more information, go to Control API access with domain-wide delegation. - You can see updates on the information below in real time while the migration is in process:
- Discovered tasks—Total number of tasks, such as crawling, creating, and updating files, folders and permissions
- Warning—Tasks that were completed but failed to complete as expected
- Failed—Tasks that failed to migrate due to an error
- Skipped—Tasks that were skipped because they were completed in a previous migration
- Successful—Tasks that were successfully completed
- Users processed—Number of users whose migration completed
- Time elapsed—Time elapsed since migration started
- Files discovered—Files migrating to Google Drive
- Folders migrated—Folders successfully migrated to Google Drive
- Files migrated—Files successfully migrated to Google Drive
- Files skipped—Previously migrated files that were skipped or files that were skipped due to the applied file filter settings
- Files failed—Files that failed to migrate in Google Drive
- Discovery issues—Folders from the source account that could not be crawled
- You can export the report at any time once the migration starts. Click Export migration report.
- If the Tasks list doesn't automatically open with the exported report, click Tasks
- Click Open in Google Sheets to open the report in Google sheets.
If you need to stop a migration while it’s in progress, click Stop migration.
Stopping a migration may take a few minutes, and it does not rollback the migration process. Any files migrated before the stop won’t be deleted from Google Drive.
You can run delta migrations and review information about a completed migration in the Admin console until you exit the migration. If you need to start a new file migration from Microsoft OneDrive, you must exit the existing migration.
Optional: Exporting logs
If you want to save logs from a completed migration, click Export migration report and Export user report.
Exiting the migration
Click Exit migration Exit and delete migration.
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.
