Import email from a Google Workspace account

1. In the Google Admin console, go to Menu Data Data import & export Data import.

   Go to Data import

   You must be signed in as a super administrator for this task.

2. For Google Workspace emails, click Import.
3. Click Source super admin email address, and enter the email address of a super administrator on the source account (the account where you are importing from).

   Important: Only the admin you specify in this field can authorize the process.

4. Click Request authorization.

   An authorization request is sent in an email to the super admin specified in step 5. The request expires in 24 hours. If the request expires and you want to resend it, click Resend request. You must wait 24 hours after you send a request before you can resend it.

Next steps

To proceed, the super admin of the source account must open the authorization link in the email, sign in to their Admin console and click Authorize. The authorization process also generates a client ID and grants domain-wide delegation for the data import tool in the source account. For more information, go to Control API access with domain-wide delegation.

If you click Verify authorization in the Admin console of the target account, the status changes to Connected.

You use an import map to connect users on the source account to users on the target account. The data import tool uses the import map to transfer email data from the source user to the target user.

1. Create the mapping file

Tip: Click Download a sample CSV to get an example comma-separated values (CSV) file that you can use.

In a spreadsheet program:

• Add the first header, Source GUser (for users' email addresses on the source account), then the second header, Target GUser (for users' email addresses on the target account).
• Using valid email addresses, map the users under the headers (both addresses are mandatory).

  You can't map a single source user to more than one target user. You can download a list of users from your Google Admin console. For details, go to Download a list of users.

• Make sure the file contains no more than 1,000 source users and doesn't exceed 128 MB in size.

  The data import tool currently supports a maximum of 1,000 users for imports to Google Workspace.

• Save the spreadsheet as a CSV file.

Example:

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

2. Upload the file

1. In the Admin console of your target account, click Upload import map CSV.
2. Go to and select your CSV mapping file click Open.
3. Click Tasks to confirm that the mapping file has successfully been uploaded.

   Note: If the CSV file doesn't load successfully, go to the next section, (Optional) 3. Delete a CSV file.

(Optional) 3. Delete a CSV file

If there is an error during the CSV upload or the upload gets stuck, you can delete the current configuration and upload a new one.

1. Select the CSV file you want to remove.
2. Click Delete .
3. Click Yes to confirm that you want to delete the CSV file.
4. To start a new upload, return to the previous section, 2. Upload the file.

1. Click Start date and enter the date that you want messages imported from.

   The data import tool imports messages from the selected date to the date that you start the import.

2. (Optional) To import email messages that have been deleted by users, check the Import deleted emails box.
3. (Optional) To import email messages with the Spam label, check the Import spam emails box.
4. (Optional) If you don't want to import messages that have specific labels, check the Exclude specific labels box, and enter the label names, separated by commas.

   For details, go to How to exclude labels (in the next section).

5. Click Save.

How to exclude labels

• Specify each label or sublabel separately.
• When you add a sublabel, use the full path and separate the parent label from the sublabel with a forward slash (/).

  Example: You want to exclude the label Travel and its child label, Asia. To do so, you enter Travel,Travel/Asia.

• If you add All Mail, the data import tool doesn't import any email messages.

You must be signed in as a super administrator for this task.

1. Click Start import.

   This action also grants domain-wide delegation and creates a client ID for Data Import in the target account. For more information, go to Control API access with domain-wide delegation.

2. The status changes to In progress and the following information is updated in real time:

   • Discovered tasks–Total number of items (messages, labels, and other tasks) that were imported, skipped, or failed
   • Warning–Number of items that were imported, but failed to complete as expected
   • Failed–Number of items that failed to import, due to an error
   • Skipped–Number of items that were skipped
   • Successful–Number of items that were imported successfully
   • Users processed–Number of users that completely imported
   • Emails discovered–Number of email messages that were imported, skipped, or failed
   • Emails imported–Number of email messages that were imported
   • Emails skipped–Number of email messages that were skipped

   When the import is complete, you get an email with import statistics. Any reports are attached.

3. To export and interpret the reports, go to Understand email import reports.

To import data that has been added to the source account since the primary import, start a delta import. For details, go to Run a delta migration.