People, guests & groups

Import user, guest, and group decisions from CSV

Review many identity matches using the template from the identity decision panel.

Quick answer

Use the identity template to choose destination_account, same_external, or exclude for each source identity. Imported decisions still need to be saved and the batch prepared again.

Your next step

Download the template for the current review. Preserve Source key so duplicate names and groups stay distinguishable.

Fill the right fields

ColumnMeaning
Source type / Source display name / Source email / Source keyThe source identity to resolve. Source key is the most reliable identifier when names repeat or a group has no email.
Resolutiondestination_account, same_external, or exclude.
Destination type / Destination display nameThe expected existing destination identity when mapping to an account.
Destination email or UPNAn exact destination address to verify for destination_account.
Destination object IDThe directory object ID; useful when names or addresses are ambiguous.

Choose the resolution

  • destination_account: provide an existing destination email/UPN, display name, or object ID. ShareRestore verifies the selected identity in the connected destination tenant.
  • same_external: use only for an eligible source external person with a valid email. Leave the destination identity fields blank.
  • exclude: record that this identity's access should not be restored.
  • There is no Send invitation column in the current template. For a new guest under same_external, Microsoft sends the invitation during approved execution.

Import, inspect, and save

  1. Download the identity CSV from the current identity review and fill it without changing source keys.
  2. Import the CSV and review each result. Correct ambiguous, missing, or incompatible identities.
  3. Apply the reviewed CSV decisions to the identity selections.
  4. For a batch, choose Save decisions and prepare again. For standalone Identity, choose Save identity decisions and rebuild the restore plan.
  5. Inspect the final destination recipients and roles before approval.

Resolve common CSV errors

Use Source key when a source name or email matches more than one identity. Add Destination object ID when a destination match is ambiguous. A group must map to a compatible destination group or be excluded; it cannot use same_external.

Use the site-mapping template for site URLs and the identity template for people and groups. Their columns solve different problems.

Continue with the next relevant guide.

Need help with your project?

Send the exact error and your project, batch, or run reference so we can investigate.

Get support