User and group mapping allows you to replace users at the destination site.
You may want to replace users or groups if they are invalid (i.e. orphaned users or groups or unresolved users or groups). A user or group can be invalid if they do not exist in the destination's Azure Directory.
Note: With Copy teams, you cannot map your groups. You can only map your users.
How-to
Select Copy from the menu.
Select the type of migration you want to perform.
Click Mappings on the top-right.
Select the Users and groups tab.
Use the search fields in the source and destination to find the user(s) or groups(s) you want to map.
Drag and drop them in the appropriate spot.
Click Save.
Two common scenarios to keep in mind when setting up your mappings:
Source user left unmapped: ShareGate Migrate automatically tries to find a matching user at the destination. If no match is found, the user becomes unresolved. See Unresolved users or groups below for what happens next.
Destination user is mandatory: If the destination has a required Person or Group column and the source user cannot be resolved at the destination, items with that user in the mandatory field will fail to migrate. You'll see an error in your migration report.
Default behavior
Users and groups at the source site are automatically mapped to existing users and groups at the destination site. You can find more about automatic mapping in the article, Users and groups association (automatic mapping).
Unresolved users or groups
ShareGate Migrate gives you the option to resolve orphaned users and groups by mapping to Unresolved users and groups. Follow the steps in the How-to above to map unresolved users or groups to a specific user or group at the destination.
If you are migrating to Microsoft 365 using Insane mode, you don't need to map unresolved users and groups because the destination preserves (i.e. keeps) the orphaned user or group information. If you want to map unresolved users or groups to a specific user or group, the migration has to be run using Normal mode.
When unresolved users and groups are not mapped:
The Modified by and Created by user fields will be filled with the migration account. You will get a warning in your Migration report.
Any item that has a custom Person or Group field will fail to migrate. You will get an error in your Migration report.
Note: ShareGate has the ability to switch between Insane mode and Normal mode depending on your content requirements. If a list or library is found containing contents unsupported by Insane mode, ShareGate will use Normal mode to migrate that entire list or library. Depending on the mode you may find metadata using the migration account information or metadata using the orphaned users or groups information.
Import and export
From the Mappings screen, you can import or
export your user and group mappings. This will allow you to save your mappings for future use. The exported file is an SGUM (ShareGate user mappings).
Considerations
To create user mappings for several users, see Create a user mapping from a CSV file.
Users and groups marked as inactive in Active Directory cannot be resolved in SharePoint and will be considered unresolved during the migration.
Users and groups you do not specify in your mappings are automatically mapped by ShareGate Migrate.
When migrating from SharePoint to Microsoft 365, if you notice some users do not resolve when mapped, it is possible they did not change their password at first login, which may have prevented them from being provisioned properly.