Home > Create User Mappings > Microsoft 365 Groups

Export to PDF

Microsoft 365 Groups

Refer to the following sections to configure user mappings for Microsoft 365 Groups to Microsoft 365 Groups / Google Groups migrations.

Microsoft 365 Groups to Microsoft 365 Groups

Refer to the following table to view the supported user/group mappings:

Source User TypeDestination User TypeMapping ValueExampleComment
Microsoft 365 UsersMicrosoft 365 Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
ADFS UsersADFS Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersGuest Usersemail address – email addressuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value supports both the user principal name and email address. Contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersGuest Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value supports both the user principal name and email address. Contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersMicrosoft 365 Usersemail address – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.

For the supported mapping values and examples of team site users, refer to the table in the SharePoint Online section.

For the supported mapping values and examples of Exchange email’s To and Cc users, refer to the table in the Exchange Online section.

Microsoft 365 Groups to Google Groups

Refer to the following table to view the supported user/group mappings:

Source User TypeDestination User TypeMapping ValueExampleComment
Microsoft 365 UserGoogle Userlogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google workspace.
Guest UserExternal Userlogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google workspace.
Guest UserInternal Userlogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google workspace.
Microsoft 365 GroupGoogle Grouplogin name – login namegroup@contoso.onmicrosoft.com - group@contosogsuite.comgroup@contoso.onmicrosoft.com represents the login name of a source group. group@contosogsuite.com represents the login name of a Google group in your destination Google workspace.
SharePoint GroupGoogle Groupspgroup:display name - login namespgroup:Contoso Group - group@contosogsuite.comContoso Group represents the display name of a source group, while the source domain is contoso.onmicrosoft.com. group@contosogsuite.com represents the login name of a google group in your Google workspace.