Create & manage an identity mapping

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

• Sharing rights assigned to users and groups
• The metadata that shows file creation and changes
• Other references that include a username

Step 1: Create a CSV file to add multiple entries

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. For groups, enter the group name.
• In the second column, enter the target domain identity. For groups, enter the group's email address in Google Workspace.
• Make sure the character encoding of the CSV file is set to UTF-8.

Tips for a successful identity mapping

• 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.
• Don't map a source identity to more than one target identity. Doing so can cause issues, such as breaking calendar events.
• To migrate organization-wide sharing permissions to Google Workspace, include a Default entry in the identity mapping. See the following example.
• If you're migrating calendar events and an event organizer is external to your organization, map the organizer in the identity mapping. To do so, add the user's email address to both the first and second column.
• View your settings template for additional options for identity mappings.

Example

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 Google Workspace Migrate platform, click New Other 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

Expand section  |  Collapse all & go to top

Update an identity mapping using a CSV file

1. In the  Google Workspace Migrate 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  Google Workspace Migrate platform, click Mappings.
2. In the Other mappings section, point to the mapping name and click Entries .
3. Click Add Add 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

If you're migrating calendar resources, go to (Optional) Set up a calendar resource migration

Otherwise, go to Set up or select a settings template

_{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.}