Migrate email from a Gmail account

• Complete the requirements in  About migrating email with the new data migration service .
• If a user is enrolled in the Advanced Protection Program, they must turn off the program before their migration is set up and while the migration is in progress. For details, refer users to  How do I turn off Advanced Protection?

You must be signed in as a  super administrator  for this task. Resellers can't migrate data for their customer accounts.

1. Sign in with a super administrator account to the Google Admin console.

   If you aren’t using a super administrator account, you can’t complete these steps.

2. Go to Menu  Data > Data import & export > Data Migration (New) .
3. For Gmail, click Migrate.
4. For Source email address, enter the address of the user’s Gmail account and click Request authorization.

   The owner of the Gmail account receives an email with a request to connect their account. To proceed, they must authorize the request. If you're the owner of the account, you can authorize the request directly from the Admin console.

5. A Pending authorization message appears as the new data migration service automatically checks if the connection request has been authorized. If this message disappears and your request still hasn't been authorized, click Verify connectionto continue checking for authorization. 
   One of the following messages is displayed:

   • Pending authorization—Wait for the account owner to authorize the request, then continue the migration process.
   • Connected—The account owner authorized your request.
   • Authorization denied—The account owner rejected your request to connect to their account. You must cancel your current request before sending a new request to connect to the same account or a different one.
   • Request expired—If the account owner doesn't authorize your request to connect to their account within 24 hours, the request expires. Click Refresh requestto resend the authorization request.

1. For Target account, enter the email address of the Google Workspace account you want to migrate data to.

   The user of this account must have a Google Workspace license and have the Gmail service turned on. For details, go to  About migrating email with the new data migration service .

2. Click Save.

1. Click Start dateand enter the date that you want messages migrated from.
   • The new data migration service migrates messages from the selected date to the date that you start the migration.

   • If you don't select a start date, by default all messages sent or received for your organization will be migrated starting from Jan. 1, 2000.

2. (Optional) To migrate email messages that have been deleted, check the Migrate deleted emailsbox.

3. (Optional) To migrate email messages with the Spamlabel, check the Migrate spam emailsbox.

4. (Optional) If you don't want to migrate messages that have specific labels, check the Exclude specific labels from migrationbox, and enter the label names, separated by a comma.

   For details, go to How to exclude labels from migration on this page.

5. Click Save.

How to exclude labels from migration

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

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

• If you add All Mail, the new data migration service doesn't migrate any email messages.

1. Click Start migration.

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

2. The status changes to In progressand the following information is updated in real time:
   • Discovered tasks—Total number of items (messages, labels, and other tasks) that were migrated, skipped, or failed
   • Warning—Number of items that were migrated, but failed to complete as expected
   • Failed—Number of items that failed to migrate, due to an error
   • Skipped—Number of items that were skipped
   • Successful—Number of items that were migrated successfully
   • Emails discovered—Number of email messages that were migrated, skipped, or failed
   • Emails migrated—Number of email messages that were migrated
   • Emails skipped—Number of email messages that were skipped
   • Emails failed–Number of email messages that didn't migrate
3. To export and interpret the report, go to Understand email migration reports .

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