Run a chat migration

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

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. Click Start migration.

   This action 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.

4. The status changes to In progress and the following information is updated in real time:
   • Discovered tasks—Total number of tasks, such as creating a space or migrating chat messages
   • 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 successfully migrated
   • Channels discovered—Number of channels that were migrated, skipped, or failed
   • Spaces created—Number of channels that were migrated to spaces
   • Spaces skipped—Number of spaces that were not created
   • Discovery issues—Number of items that were unable to be read from the source account
5. Click View report to download the reports in CSV format. Once the migration starts, you can download the report at any point.
6. If the Tasks list doesn't automatically open with the downloaded report, click Tasks .
7. For Your Tasks, click the link to open the report.
8. Click Download CSV to download the report.

During a delta migration, chat migration copies any messages added to Teams since the primary migration. Messages that are already successfully migrated are skipped.

Note: You can't run a delta migration after you click Roll out spaces.

To start a delta migration, in your Google Admin console, click Run delta migration.

After you complete the delta migration, make the migrated spaces and messages available to Google Workspace users. You must complete this process within 30 days of the start of the migration, or the migrated spaces are deleted.

Important: Don't complete these steps if you still need to run a delta migration. You can't run a delta migration after you click Roll out spaces.

1. In your Google Admin console, click Roll out spaces.

   In real time, you can review the number of spaces and messages that successfully migrated.

2. When the process is complete, click Download logs to view information about which spaces and members were successfully added to users' Google Workspace accounts.

   Note: If any spaces fail to migrate, click Roll out spaces again to retry the process on all the spaces that failed to migrate.