User Mapping
Match source tenant users to target tenant users so group members and owners migrate correctly.
Primera Labs adds group members and owners as existing users in the target tenant. User Mapping tells it which target user each source user becomes.
Members and owners who aren't mapped are skipped. The group is still migrated, but without them, and the job lists the group under Completed with notes.
Where the list comes from
When you discover groups, every member and owner is added to User Mapping as a row with no target user. You don't need to add source users yourself.
The page shows:
- How many users are still unmapped
- A Group owner badge on users who own discovered groups. Tick Group owners only to show just those users.
- A warning when group owners aren't mapped. Groups are created without an unmapped owner.
Ways to map users
Dynamic Mapping
Dynamic Mapping appears when there are unmapped users. It looks each unmapped user up in the target tenant and matches on:
- the same display name, or
- the same email address
Matches ignore upper and lower case. It doesn't match on UPN.
When it finishes, you get a summary:
- Auto-Mapped: exactly one match was found, so the mapping was saved.
- Conflicts (manual review needed): more than one target user matched. Nothing is saved, and the matching users are listed in the row's Notes for you to choose from.
- No Matches Found: nothing matched. This is written in Notes.
Note
Dynamic Mapping only looks at the first 999 users in the target tenant. In larger tenants, use a CSV import instead.
Import a CSV
- Click Template to download
user_mapping_template.csv. - Fill in one row per user. SourceUPN and TargetUPN are required. SourceDisplayName, SourceEmail, TargetDisplayName, TargetEmail and Notes are optional.
- Click Import CSV and choose the file.
You'll see how many rows were imported and how many failed. A row whose SourceUPN already exists updates that mapping.
A common approach: click Export to download the current list, including the source users from discovery. Fill in the target columns in a spreadsheet, then import it again.
Add or edit one mapping
- Add Mapping creates a mapping by hand. Enter the source and target UPN, and optionally display names, emails and notes.
- The edit icon on a row changes its target user. The source user can't be changed.
- The delete icon removes a mapping.
Who can map users
Owners, Admins and Operators can add, edit, import and delete mappings. Reporters can only view them. See Team and Roles.
Tips
- Map owners first. Unmapped owners are the most visible gap after migration.
- Service accounts. If a service account you aren't migrating owns groups, map it to the account that should own them in the target.
- Check before you migrate. The unmapped count should be zero, or only include people you've decided to leave out.
- Changing a mapping later is fine. Rerun Pre-Stage and newly mapped members are added to groups that already exist.
Was this page helpful?
Something wrong or out of date?