Note: PowerShell integration requires a ShareGate Migrate Pro or Enterprise subscription. It is not available on the Essentials plan.
While ShareGate Migrate automatically maps your mailboxes and recipients, you can review and modify these mappings to ensure proper functionality in your destination mailboxes.
Note: We recommend reading the Copy mailboxes limitations article before running a mailbox migration.
Review and adjust your mappings
When you set up your Copy mailboxes operation, ShareGate Migrate takes you to the mailbox and recipient mapping screen right after you connect your tenants.
Automatic mapping is applied during your initial configuration, and you can review and modify this mapping. Use the following options to change your mappings:
Type the name or email of a source mailbox in the Search by user name or email field at the top to find a source mailbox you want to map.
Select one of the following filters to review your mappings:
All to display all your mailboxes.
Match found to show only your already-mapped mailboxes.
Warnings to display unmapped mailboxes.
Click the Export mappings icon to export your mappings as a CSV file.
Click the Import mappings icon to import mappings.
You must use a CSV file exported with Copy mailboxes in ShareGate Migrate, or precisely in the same format.
Your CSV does not need to include all your mappings. When you import mappings with a CSV file, ShareGate Migrate will only replace the mappings specified in your CSV file. It will not clear the other mappings.
If no destination information is entered in the CSV file for a mailbox, that mapping is skipped.
If only one of the destination fields (for example, Destination user name) is entered and ShareGate Migrate faces an uncertain match (for example, two users with identical display names), you will get a warning to search for a matching user manually.
To manually map a mailbox, select your source mailbox and a mapping sidebar will appear.
If the mailbox was already mapped, click the X next to the destination mailboxe's name to remove that mapping.
Use the Search a destination mailbox field and start typing an account name to find your desired destination mailbox.
You can only map mailboxes of the same type. For example, you can map a user mailbox to a user mailbox, but you cannot map a user mailbox to a shared mailbox.
Click Save changes to save that mapping.
Considerations
Mailbox and recipient mappings
Guests and External users are not supported (see Copy mailboxes limitations).
Mappings are saved and reloaded when you launch a second migration with the same source and destination.
When a match is not found during the automatic mapping process, the destination mailbox appears as a yellow search box with the message, No match found, try searching manually under it.
To ensure all replies and emails go to the new inboxes, users set up automatic forwarding to their new email addresses at the source, or you can do it for them in the Exchange admin center (EAC).
Mailbox mappings only
Unmapped mailboxes are not copied.
Recipient mappings only
Your mapped mailboxes from the Mailbox mapping screen are not shown and are used as recipients by default.
Mapping your recipients correctly ensures that the migrated emails can be replied to.
You can only map internal recipients listed in the destination tenant.
Unmapped recipient email addresses remain as they are in the source.
You cannot map external and guest users' recipient email addresses since out-of-tenant addresses should still be available for replies.