Map Users and Groups

Map Users and Groups allows you to replace users that are not valid to existing ones on the destination site so everything works as intended.

Index

• How-To
• Default Behavior
• Unresolved users or groups
  • Metadata
• Import and Export
• Things to note

How-To

1. Click Copy.
2. Selected the action you want to perform from the Copy menu and connect to a source and a destination.
3. Click  in the top right corner.
4. Select the Users and Groups tab (you can only map users when with Copy teams).
5. Search for the user or group in the source and destination.
6. Drag and drop them in the appropriate spot.
7. Click Save.

Tip: If you wish to create user mappings for many users click here.

Default Behavior

Users and groups are automatically mapped with existing users and groups on the destination site. You can find more about automatic mapping in the Users and groups association article.

Unresolved users or groups

You can set a user or group to replace any user or group that existed at the source, but doesn't exist at the destination. A common scenario is between SharePoint environments where some users in the source have left the organization and don't exist on the destination site.

ShareGate Desktop will preserve orphaned users while migrating in Insane Mode to Microsoft 365. To ensure that the mapping of the unresolved users and groups is applied, the migration has to be run in Normal Mode, otherwise, ShareGate Desktop will consider the users as resolved since they can be preserved in Insane Mode.

Metadata

For the Modified By and Created By user fields, unresolved users and groups will be replaced by the migration account when they are not mapped (you will get a warning in your migration report).

Any item that has an unresolved user or group in a custom Person or Group field will fail to migrate when they are not mapped (you will get an error in your migration report).

Import and Export

You can import  or export  from/to SGUM ( ShareGate User Mappings file type). This will allow you to save your mappings for future use.

Note: When migrating from SharePoint to Microsoft 365, if you notice some users do not resolve when mapped, it is possible that they did not change their password at first login - causing them to not be provisioned properly.