MigrationWiz - Advanced Options & General Options

When you created a project, you defined the Source, the Destination, and the items that need to be migrated. This can be mailboxes, documents, archives, etc. The MigrationWiz project also has Advanced Option features that will allow you to customize the project even more.

These are broken down into General Options and Advanced Options. Under Advanced Options, you may also use Support Options to further configure your project. 

To access your options: 

  1. Click Edit Project.
  2. Click Advanced Options.


General Options

These options are basic-level configurations.


  • Send successful migration email notifications: Choose who to notify when a migration has been executed successfully.
  • Send failed migration email notifications to: Choose who to notify when a migration fails.
  • Customize Notification Email: Customize for email for success, failure, and request for credentials. Use certain keywords as codes for certain data. 
    Note: OAuth 2.0 does not use the customized email; it will only use the default

Note: You can use Markdown syntax to format your email. 


The filtering tabs allow for specific ranges to be migrated. You can choose the By Date or By Folder filtering options.

  • Specify the earliest date from which to migrate: Migrates everything that is newer than this date.
  • Specify the latest date from which to migrate: Migrates everything that is older than this date.
    Note: Any date filters that have been set here will be overridden by the date filters that are set under Start/Pre-Stage migration.
  • Filter folders (RegEx): Define Regular Expressions commands to filter the folder to be migrated. This option is found under the By Folder tab.


  • Number of days after which this project will be auto-deleted if unused: We only keep a project as long as necessary. When a project is not being used, we will delete it after 180 days of inactivity unless otherwise defined in this parameter.
  • Log subjects of failed items: When an item was not migrated successfully, retry the errors with this option selected to retrieve the subject and path of the item if it is available.


  • Licensing allows you to set up a maximum number of licenses to use per item.


  • Preferred Data Center: Our migrations run in multiple data centers all over the world. Choose which data center should run the migration. By default, we select the data center closest to the authenticated user running the migration.
  • Max. concurrent migrations: This parameter defines how many migrations to allow simultaneously. Submit as many migrations as you like, we will only allow this number of migrations to be active concurrently.
  • Max. errors of migration: When an error occurs during the migration, we check to see if the number of errors that we received reaches this threshold. If it does, we call the migration a failure. Otherwise, we keep on going.

Specific Migration Type Options


  • Source:
    • Migrate From: Choose between migrating from Mailbox, Archive (only with archive project) or Recoverable items.
      Note: If migrating from Recoverable items, then we recommend that you have litigation hold on.
    • Use  Impersonation to Authenticate
  • Destination:
    • Migrate From: Choose between migrating to Mailbox, Archive, or Recoverable items.
      Note: If migrating to Recoverable items, then we recommend that you have litigation holds enabled.
    • Destination Mailbox Language
    • Use  Impersonation to Authenticate.

Failing Items

Several options can impact whether certain items in a mailbox get migrated. Make sure these options are not blocking the migration of items you have intended to migrate.

Project Level

Check to see if you have one or more of the following enabled under Advanced Options:

  • Folder filtering
  • Date filtering
  • Item type filtering (not migrating calendars, mail, contacts, etc)

Item Level

Check to see if you have one or more of the following enabled under Advanced Options​:

  • Folder filtering
  • Item type filtering​ (not migrating calendars, mail, contacts, etc)


Advanced Options

 These options will further configure your migration and will allow for special processes.

Migrate to Archive

You may perform an archive-to-archive migration simply by setting the Destination Advanced Option within an Archive migration to “Migrate to: Archive”.

Recipient Mappings

Recipient mappings are a useful way to ensure that:

  • All email remains replyable to, post-migration, even after a Full (Delta) Migration has occurred when performing a tenant to tenant migration, while keeping the same domain name; or when changing domain names from Source to Destination.
  • Calendar ownership and display name match on destination when performing a tenant to tenant migration, while keeping the same domain name; or when changing domain names from Source to Destination.

    Note: If you are using recipient mapping while migrating from one Source domain to multiple Destination domains, a project is required for each Destination domain.

Use cases:

  • When migrating from Office 365 to Office 365 and keeping the same domain name, recipient mappings must be added to your project, as directed below. This is included in the migration guide for this scenario.


  • When you are migrating over to a new domain name.
    • Source domain = Sourcedomain.com
    • Destination domain = Destinationdomain.com
    • Example - Migrating James@Sourcedomain.com to james@Destinationdomain.com you want to ensure that any entries for james@Sourcedomain.com are renamed to james@Destinationdomain.com during migration.

          `RecipientMapping="@sourcetenant.onmicrosoft.com->@destinationdomain.com"`                                    `RecipientMapping="@sourcedomain.com->@destinationdomain.com"`


Was this article helpful?
0 out of 0 found this helpful