Identity Mapping

Identity mapping defines how users in the source tenant correspond to users in the target tenant. Every migration step references this mapping as the single source of truth.

Auto-match

TenantLift can automatically match users based on:

• Display name — exact or fuzzy matching
• UPN — matching the local part (before @) across tenants
• Email addresses — matching primary or proxy SMTP addresses

To use auto-match, click Auto-Match on the Identity Mapping page. Review the suggestions and approve or adjust each match.

CSV import

For full control, upload a CSV with two columns:

SourceUPN,TargetUPN
alice@contoso.com,alice@fabrikam.com
bob@contoso.com,robert.smith@fabrikam.com

Upload via Import CSV on the Identity Mapping page.

Reviewing the map

The mapping table shows:

• Source user (UPN, display name)
• Matched target user
• Match confidence (auto-match only)
• Status: Mapped, Unmatched, Conflict

All unmatched users must be resolved before you can proceed to pre-flight.

Editing mappings

Click any row to change the target user. You can also:

• Exclude a user from migration
• Add a manual mapping for users not found by auto-match