Create & manage a mapping

A mapping determines what content gets migrated and where it gets migrated to. As you add entries to a mapping, Google Workspace Migrate can validate that the source and target locations exist.

Before you begin

Review Scoped view & mapping headers.
Familiarize yourself with the monitoring points and best practices for mapping shared drives.

Create a CSV file to add multiple entries

You can add multiple entries using a CSV file. The file is similar to 2 scoped views. One scoped view specifies the source data, and the other specifies where the data should be on your new domain. Just like a scoped view, you can use multiple columns, each with a header.

Create the CSV file using the following format:

Preface source-connection column headers with Source.
Preface target-connection column headers with Target.
Format each entry according to the syntax requirements of the connection type.
All entries in a mapping are case-sensitive.
Make sure the character encoding of the CSV file is set to UTF-8.

Step 1: Create a mapping

Create a mapping

Create a mapping using a CSV file

In the Google Workspace Migrate platform, click New Mapping.
Enter a name for the mapping.
From the Source connection list, select the source connection.
From the Target connection list, select the target connection.
Click Upload CSV file or drag a file to the box.
Click Create.

Note: If you point to the mapping and click Entries , under Source validity and Target validity, you might see "Imported entry requires validation." You validate the entries in step 2.

Manually create a mapping

In the Google Workspace Migrate platform, click New Mapping.
Enter a name for the mapping.
From the Source connection list, select the source connection.
From the Target connection list, select the target connection.
Click Create.
Point to the mapping name and click Entries .
Click Add Add entries manually.
Click the Down arrow to expand your selection to the next level of hierarchy.
Check the box or boxes next to the source data you want to migrate.
Tip: To find a user, enter a string in the Search users field. All users matching that string are listed.
Click Next.
Click the Down arrow to expand your selection to the next level of hierarchy.
Check the box or boxes next to the target location Next.
(Optional) To migrate the contents of a folder but not the folder, under Map content only, click Turn on .
For example, to map the contents of the Receipts folder to My Drive, turn on Map content only. Everything in the Receipts folder migrates to My Drive, but not the Receipts folder itself.
Click Add.
(Optional) To map data to a folder that doesn't currently exist in Drive, under Custom, click Add, enter the folder path, then click Done.
You can map only data to a folder in Drive by adding a folder path. You can’t map email messages to a label.
(Optional) Repeat the steps to add new entries to the mapping.

Update a mapping (Optional)

Update a mapping using a CSV file

In the Google Workspace Migrate platform, click Mappings.
In the Mappings section, point to the mapping name and click Entries .
Click Add .
Click Upload CSV file or drag a file to the box.
Click Import.

Note: Google Workspace Migrate might reformat source and target locations after the CSV file is imported.

Add individual entries to a mapping

In the Google Workspace Migrate platform, click Mappings.
In the Mappings section, point to the mapping name and click Entries .
Click Add Add entries manually.
Check the box or boxes next to the source data you want to migrate.
Click the Down arrow to expand your selection.
Click Next.
Check the box or boxes next to the target location.
Click the Down arrow to expand your selection.
Click Next.
(Optional) To migrate the contents of a folder but not the folder, under Map content only, click Turn on .
For example, to map the Receipts folder to My Drive, turn on Map content only. Everything in the Receipts folder migrates to My Drive, but not the Receipts folder itself.
Click Add.
(Optional) Repeat the steps to add new entries to the mapping.

Delete a mapping entry

Point to the mapping and click Entries .
Next to the entry, check the box.
Click Delete Delete.

Step 2: Validate a mapping entry

When validating a mapping, Google Workspace Migrate verifies whether the source and target locations exist. It doesn’t evaluate if the mapping is logical or will work for your data.

Point to the mapping and click Entries .
Check all entries and click Validate .
If you see a:
- Green check—Entry is valid.
- Red cross—Entry is invalid. Check the error message.
- Gray clock—Entry has expired. The entry must be revalidated before you run a bridge.

Note: Validation can take several minutes.

Next step

Create & manage an identity mapping

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