Pause, cancel, or exit a migration

When you use the data migration service, you can pause, restart, cancel, or exit a migration.

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

Manage a migration

Expand all  |  Collapse all

Before you begin

To access the data migration service in the Google Admin console:

  1. Sign in to your Google Admin console.

    Sign in using an account with super administrator privileges (does not end in @gmail.com).

  2. In the Admin console, go to Menu and then Dataand thenData import & exportand thenData migration (New).
Pause & restart a migration

To pause and restart a migration:

  1. Do one of the following actions:
    • To pause a migration for all users, leave the boxes next to all users unchecked and click Moreand thenPause all migrations in the Migrations table.

    • To pause a migration for certain users, check the box next to the users and click Pause user migration.

  2. Select the accounts you would like to resume and click Resume user migration. The data migration service resumes where it left off.

Note: After you pause a migration, the migration process can continue for up to 10 minutes.

Cancel a migration to edit the settings

If you want to edit the migration settings during a running migration, you must first cancel the migration.

To cancel a migration for all users, click Moreand thenExit migration in the Migrations table.

If you cancel a migration that’s in progress and run the same migration again later, the data migration service restarts and migrates all the data again. However, your new Google Workspace email account automatically identifies duplicate messages and eliminates them.

Exit a completed migration

Verify the status of a migration

When the migration finishes, the word Complete appears in the Status column for a user in the Migrations table. To view metrics about a migration, point to Complete in the Status column. A tooltip displays the following statistics:

  • Items successfully migrated
  • Items that failed to migrate
  • Total items discovered

How to exit

To exit a completed migration, click Moreand thenExit migration in the Migrations table.

Metrics for a completed migration

When you exit a migration, a migration report is sent to all super administrators of the account and the migration role account.

Information about a completed migration is displayed on the Data Migration page for 15 days, or until you exit the migration. Once you exit a migration, the ability to send further reports is no longer available.

A migration exits automatically after 15 days. If it does, you won't receive a migration report.

Tip: It’s important to track a migration’s progress so you don’t miss this reporting information. Check a migration's progress every few days and exit the migration if it's successful.


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.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
3638204824305337754