This article provides detailed instructions on configuring a migration batch to move users' mail data from an IMAP source to Google Workspace user accounts.
Before you start, ensure you have already set up your migration project and created a user batch as outlined in our Migration Guide.
1. Adding Entities to Your Batch
Before configuring migration settings, you must add entities to your migration batch. This step defines what data is being migrated and its destination. Use the following format for each entity you add:
-
*Export Type:
User - *Export Name: The primary email address of the source user.
-
*Import Type:
User - *Import Name: The primary email address of the destination user.
- Given Name: The user's first name in the destination. (This can be left blank if the user account already exists in Google Workspace).
- Family Name: The user's last name in the destination. (This can be left blank if the user account already exists in Google Workspace).
- *Password: The user's password for the source IMAP account.
*Mandatory Field
Further instructions on adding entities to your batch can be found here: Adding Items to a migration batch
For each entity added, you can select the specific data types you wish to migrate. Ensure the 'Migrate' checkbox is enabled for all entities you intend to include in the migration run. For this guide, ensure "Mail" is selected.
2. Configuration Settings
Once users are added to your batch, you must review and configure the migration settings. These are separated into several sections:
General Settings
- Review Domain Names: Correctly configure all domain mappings. This is essential for replacing the source domain with the destination domain on email addresses and permissions during the migration.
- Date Filters: You can apply date range filters to migrate data created within a specific timeframe. If no filter is set, all mail items will be migrated regardless of age.
For more detailed information on General Settings, please review the article below:
Source Platform Settings
For a standard user-to-user IMAP migration, most source settings can remain at their default values. If you would like to modify any additional source settings, please review the below article:
Destination Platform Settings
If you would like to modify any additional destination Email and User settings specific to Google Workspace, please review the below article:
Google Workspace - Destination Settings
Advanced Settings
For a standard user-to-user migration, most advanced settings can remain at their default values. However, consider the following:
- Address Replacement: It is highly recommended to upload an address replacement CSV that maps source users to their corresponding destination users. This ensures permissions are correctly migrated. For more information, please refer to the Address Replacements article.
Additional settings are outlined here: Advanced Settings
3. The Migration Process (Overall Strategy)
For a complete, in-depth guide that covers project planning, user communication, and detailed pre- and post-migration checklists for your entire migration project, please review our comprehensive recommended strategy article: