About settings template options

Google Workspace to Google Workspace migration

You can migrate Google Workspace content to your users' Google My Drive or shared drives. Each settings template has options that you can enable, depending on how you want your data to appear after a migration. Make sure you use the correct settings template for your migration. View the template details below.

Open all   |   Close all

Default

Migrate Drive content

Migrate folders

Enabled by default

When enabled, Drive folders are migrated.

Migrate files

Enabled by default

When enabled, Drive files are migrated.

Check the Migrate revisions box to migrate versions of files.

Migrate Google Docs

Enabled by default

When enabled, Docs are migrated.

Migrate Google Sheets

Enabled by default

When enabled, Sheets are migrated.

Migrate comments

Enabled by default

When enabled, comments are migrated. Applies to Drive platform-specific files.

Migrate sharing permissions

Enabled by default

When enabled, sharing permissions are migrated along with the objects to Drive.

If enabled, you can choose to migrate sharing permissions and enable the Allow email invitations setting (off by default). If you do so, users outside your organization who are assigned permissions for a Drive folder or file are sent an email notification.

Migrate Mail content

Migrate mail

Enabled by default

When enabled, Gmail content is migrated.

To migrate Gmail settings, check the Include settings box. If enabled, you can choose to include these settings, which are on by default:

  • Include autoforwarding settings
  • Include delegate settings
  • Include filter settings
  • Include forwarding settings
  • Include IMAP settings
  • Include POP settings
  • Include send as settings (migrates the signature for the primary Gmail account)
  • Include vacation settings

Check the Accelerate old messages box and the migration performance is modestly increased.

If you turn on this setting, you have the option of checking the Restrict insert by date box and specifying a date in the Insert before date field. Email data that’s dated before the Insert before date is accelerated during a migration.

Enabling this setting can cause data duplication and prevent message threading in certain circumstances. For example, if a user sets up email forwarding to their new Gmail account, forwarded messages are duplicated during a migration. Forwarded messages appear separately, rather than as part of an email thread.

Important: We recommend using the setting for large or archival mailboxes. If you're unsure, do not use this option.

Learn more about Gmail APIs:

Migrate tasks

Enabled by default

When enabled, Google Tasks and Task folders are migrated.

Migrate Contacts content

Migrate contacts

Enabled by default

When enabled, all the migration options for Contacts are turned on.

Migrate Calendar content

Migrate calendars

Enabled by default

When enabled, all the migration options for Calendar are turned on.

Migrate calendar permissions

Enabled by default

When enabled, Calendar permissions are migrated.

Upload calendar event attachments to Drive

Enabled by default

When enabled, migrated calendar event attachments are uploaded to Drive.

Filter Drive content

Note: All string-based filters are not case-sensitive.

Exclude Google Drive folders

Exclude Google Drive files

Exclude Google Docs

Exclude Google Sheets

Exclude Google permissions

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.
  3. (Optional) To set multiple filters, click Add filter and repeat the steps above.
  4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box.
    You’ll see excluded objects as skipped transactions in the transaction log. If you check the box, you won’t see excluded objects in the log.
  5. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
Filter Mail content

Note: All string-based filters are not case-sensitive.

Exclude Gmail labels

Exclude Gmail messages

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.
  3. (Optional) To set multiple filters, click Add filter and repeat the steps above.
  4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box.
    You’ll see excluded objects as skipped transactions in the transaction log. If you check the box, you won’t see excluded objects in the log.
  5. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
Filter Contacts content

Note: All string-based filters are not case-sensitive.

Exclude Google Contacts

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.
  3. (Optional) To set multiple filters, click Add filter and repeat the steps above.
  4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box.
    You’ll see excluded objects as skipped transactions in the transaction log. If you check the box, you won’t see excluded objects in the log.
  5. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
Filter Calendar content

Note: All string-based filters are not case-sensitive.

Exclude Google Calendar

Exclude Google Calendar events

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.
  3. (Optional) To set multiple filters, click Add filter and repeat the steps above.
  4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box.
    You’ll see excluded objects as skipped transactions in the transaction log. If you check the box, you won’t see excluded objects in the log.
  5. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
User mapping

Map users

Enabled by default

When enabled:

  • Users are mapped according to the identity mapping associated with the bridge.
  • Your identity mapping should include users who are the same on the source and target environments. You can omit these users if the Allow unmapped users setting is enabled (details below).

Allow unmapped users

When enabled, all user permissions are migrated, including users who aren’t specified in the identity mapping.

Note: If your organization does not allow sharing with users outside of the organization, enabling this setting might cause errors.

Domain mapping

When enabled, Google Workspace Migrate automatically maps source domain usernames to target domain usernames (for example, user1@ on your source domain becomes user1@ on your target domain). If you enable this setting:

  • In the Source domain field, enter the source domain.
  • In the Target domain field, enter the target domain.

Note:

  • Using this setting requires that the domain-relative usernames of the source and target domain are identical.
  • If you’re using an identity mapping, Google Workspace Migrate first checks that mapping for a new username. If it doesn’t find a new username, Google Workspace Migrate uses this setting to generate one.

Migrate My Drive to shared drives

Migrate to shared drive

Migrate folders 

Enabled by default

When enabled, My Drive folders are migrated to shared drive folders.

If enabled, you can choose to Migrate Google Drive folders with restricted permissions (off by default). Child folders that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those folders are skipped.

File migration approach

Enabled by default

Select either Migrate files or Skip files. If Migrate files is enabled, you can choose to:

  • Migrate revisions (on by default)
  • Migrate Google Docs (on by default)
  • Migrate Google Sheets (on by default)
  • Migrate comments (on by default).
  • Migrate Google Drive files with restricted permissions (off by default)

Migrate folder permissions

Enabled by default

When enabled, folder permissions are migrated to the target shared drive.

Restricted permissions are not migrated. Go to Migrating permissions to shared drives.

Migrate file permissions

Enabled by default

When enabled, file permissions are migrated.

Restricted permissions are not migrated. Go to Migrating permissions to shared drives.

Filter Drive content

Note: All string-based filters are not case-sensitive.

Exclude Google Drive folders

Exclude Google Drive files

Exclude Google Docs

Exclude Google Sheets

Exclude Google permissions

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions. 
  3. (Optional) To set multiple filters, click Add filter and repeat the steps above. 
  4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box. You’ll see excluded objects as skipped transactions in the transaction log. If you check the box, you won’t see excluded objects in the log. 
  5. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
User mapping

Map users

Enabled by default

When enabled:

  • Users are mapped according to the identity mapping associated with the bridge.
  • Your identity mapping should include users who are the same on the source and target environments. You can omit these users if the Allow unmapped users setting is enabled (details below).

Allow unmapped users

When enabled, all user permissions are migrated, including users who aren’t specified in the identity mapping.

Note: If your organization does not allow sharing with users outside of the organization, enabling this setting might cause errors.

Domain mapping

When enabled, Google Workspace Migrate automatically maps source domain usernames to target domain usernames (for example, user1@ on your source domain becomes user1@ on your target domain). If you enable this setting:

  • In the Source domain field, enter the source domain.
  • In the Target domain field, enter the target domain.

Note:

  • Using this setting requires that the domain-relative usernames of the source and target domain are identical.
  • If you’re using an identity mapping, Google Workspace Migrate first checks that mapping for a new username. If it doesn’t find a new username, Google Workspace Migrate uses this setting to generate one.

Related topic

Set up or select a settings template


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.