Create & manage a mapping

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

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

Before you begin: Review the mapping headers for Exchange, SharePoint, file shares, G Suite, or Box.

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 

  1. In the G Suite Migrate platform, click New ""and thenMapping.
  2. Enter a name for the mapping.
  3. From the Source connection list, select the source connection.
  4. From the Target connection list, select the target connection.
  5. Click Upload CSV file or drag a file to the box.
  6. 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 

  1. In the G Suite Migrate platform, click New ""and thenMapping.
  2. Enter a name for the mapping.
  3. From the Source connection list, select the source connection.
  4. From the Target connection list, select the target connection.
  5. Click Create
  6. Point to the mapping name and click Entries "".
  7. Click Add ""and thenAdd entries manually.
  8. Check the box or boxes next to the source data you want to migrate.

    Click the Down arrow "" to expand your selection.

  9. Click Next.
  10. Check the box or boxes next to the target location.

    Click the Down arrow "" to expand your selection.

  11. Click Next.
  12. (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.

  13. Click Add.
  14. (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
  15. (Optional) Repeat the steps to add new entries to the mapping. 
Update a mapping (Optional)

Update a mapping using a CSV file

  1. In the G Suite Migrate platform, click Mappings.
  2. In the 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.

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

Add individual entries to a mapping

  1. In the G Suite Migrate platform, click Mappings.
  2. In the Mappings section, point to the mapping name and click Entries "".
  3. Click Add ""and thenAdd entries manually.
  4. Check the box or boxes next to the source data you want to migrate.

    Click the Down arrow "" to expand your selection.

  5. Click Next.
  6. Check the box or boxes next to the target location.

    Click the Down arrow "" to expand your selection.

  7. Click Next.
  8. (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.

  9. Click Add.
  10. (Optional) Repeat the steps to add new entries to the mapping.

    Delete a mapping entry

  1. Point to the mapping and click Entries "".
  2. Next to the entry, check the box.
  3. Click Delete ""and thenDelete.

Step 2: Validate a mapping entry

  1. Point to the mapping and click Entries "".
  2. Check all entries and click Validate "".
  3. 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 and manage an identity mapping for Exchange, SharePoint, file shares, G Suite, or Box

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.