Create a user-mapping file for data content migration in Migration Manager

This article shows how to create a user-mapping file to use with Migration Manager. Use Migration Manager to migrate your file shares to Microsoft 365.

Create a user-mapping file for data content migration

Migration Manager uses a default user-mapping file when migrating your file shares. However, you can choose to create your own user-mapping file using the following guidelines. Create the CSV file using any text editor or an application like Excel.

CSV file format

Important

Don't include a header row in your CSV file.

The following example uses Excel to create the CSV file.

  1. Start Excel.
  2. Enter the values for your user-mapping.
  • Column A: From the source location, enter the login name of the user. For example, DOMAIN\username. Required.
  • Column B: On the destination site, enter the user principal name (UPN). For example, username@domain.com. Required.
  • Column C: If the user principal name on the destination site is an Active Directory (AD) group, enter TRUE. If it's not an AD group, enter FALSE. Required.
  1. Close and save as a comma-delimited (*.csv) file.

Upload your user-mapping file to Migration Manager

After you create your own user-mapping file, upload it to Migration Manager in the SharePoint admin center.

  1. Go to the Migration center in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.
  2. Select Global settings.
  3. Select All settings.
  4. Select User mapping file, and then select Choose file to browse to the file to use.
  5. Select Save.

Note

It's not possible to map an AD group to a SharePoint group in the destination site.

  • Last updated on