Create & manage an identity mapping

If you're migrating from OneDrive for Business, follow the instructions for SharePoint unless specified.

Use an identity mapping to transfer identities (such as users or calendar resources) on your source domain to identities on your G Suite domain. An identity mapping ensures that user and group permissions in the source environment are transferred to your G Suite domain, including:

  • Sharing rights assigned to users and groups.
  • Creation and modification metadata.
  • Other references that include a username.

Note: View your settings template for additional identity mapping options.

Step 1: Create a CSV file to add multiple entries

You can add multiple entries using a CSV file. Create the CSV file using the following format:

  • In the first column, enter the identity with the syntax as it appears in the source environment.
  • In the second column, enter the target domain identity.
  • If you're migrating from Microsoft Exchange, include a Default entry in the identity mapping. If you don’t, organization-wide sharing permissions won’t be transferred to G Suite.
  • Make sure the character encoding of the CSV file is set to UTF-8. 

Important: Include all identities in the identity mapping, even if you don’t plan on migrating all data at once. Identities might be referenced in non-user specific data, such as calendar events or sharing permissions.

Exchange identity mapping CSV file

In this example, the source domain environment is example.com. The target domain environment is solarmora.com.

Step 2: Create an identity mapping

  1. In the G Suite Migrate platform, click New ""and thenOther mapping.
  2. Enter a name for the mapping.
  3. Under Type, select Identities.
  4. Click Upload CSV file or drag a file to the box.
  5. Click Create.

Update an identity mapping

Open all   |   Close all

Update an identity mapping using a CSV file
  1. In the G Suite Migration platform, click Mappings.
  2. In the Other mappings section, point to the mapping name and click Entries "".
  3. Click Add "".
  4. Click Upload CSV file or drag a file to the box.
  5. Click Import.
Add individual entries to an identity mapping
  1. In the G Suite Migration platform, click Mappings.
  2. In the Other mappings section, point to the mapping name and click Entries "".
  3. Click Add ""and thenAdd entries manually.
  4. Enter a source and target value. If you want to add another value, click Add "" and enter the new value.
  5. After you enter all the new values, click Add.
Edit individual entries in a mapping
  1. In the Other mappings section, point to the mapping name and click Entries "".
  2. Point to the entry that you want to update and click Edit "".
  3. Update the source or target value and click Save.

Next step for Exchange, file shares, G Suite, or Box

Set up or select a settings template with Exchange, file shares, G Suite, or Box.

Next step for SharePoint

Map roles from SharePoint to G Suite.

Google, G Suite, 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.