Google Workspace (Gmail)

1. Prepare a secret, link a domain, and prepare employee accounts if you haven't already done so. Make sure that the names of the source and target domains match.

2. In the left menu, select General settings → Migration.

3. Select what you want to migrate: click Migrate email.

4. Select where you want to migrate email from: click Google Workspace.

5. Upload the secret file and click Next.

6. Specify the accounts for which you want to start migration:

   1. Download the CSV file template.

   2. Following the example, add employee data to the file.

      The first row in the file is the account field headers. Each following line must contain data for one account, delimited by a semicolon and in quotation marks.

      You must provide the addresses of the original mailboxes into which you want to migrate email, as well as employee usernames on your domain.

      Note

      You can add up to 20,000 usernames.

   3. Save the CSV file in UTF-8 encoding (in Microsoft Excel, click Save as → CSV-UTF8).

      Alert

      If you save the file in a different encoding, it won't be recognized correctly.

   4. Click Upload CSV and select your file.

7. Click Start migration.

   The status will change to Migrating.

   

Troubleshooting

Take note of the following possible errors and ways to fix them.

The uploaded secret is invalid

Make sure that you prepared the secret correctly.

The first line in the CSV file has been deleted or changed

Download the CSV file template and copy the first line from it to your CSV file. Make sure that the previous import is completed and start a new import with the corrected CSV file.

The source and target domain names don't match

Before starting migration, make sure that the source and target domain names match. Otherwise, you won't be able to start migration.

To view the report with a detailed description of errors, click Details in the top right corner of the active migration page. For ways to fix these errors, see Migration error report.