Understand settings templates

G Suite to G Suite migration

You can migrate G Suite 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
Setting Enabled by default? Details
Migrate folders When enabled, Drive folders are migrated.
Migrate files When enabled, Drive files are migrated.

Check the Migrate revisions box to migrate versions of files.

Migrate Google Docs When enabled, Docs are migrated.
Migrate Google Sheets When enabled, Sheets are migrated.
Migrate comments When enabled, comments are migrated. Applies to Drive platform-specific files.
Migrate sharing permissions 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 domain who are assigned permissions for a Drive folder or file are sent an email notification.

Migrate Mail content
Setting Enabled by default? Details
Migrate mail 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
  • 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. When the option is:

Migrate tasks When enabled, Google Tasks and Task folders are migrated.
Migrate Contacts content
Setting Enabled by default? Details
Migrate contacts When enabled, all the migration options for Contacts are turned on.
Migrate Calendar content
Setting Enabled by default? Details
Migrate calendars When enabled, all the migration options for Calendar are turned on.
Migrate calendar permissions When enabled, Calendar permissions are migrated.
Upload calendar event attachments to Drive When enabled, migrated calendar event attachments are uploaded to Drive.
Filter Drive content

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

Setting Enabled by default? Details

Exclude Google Drive folders

Exclude Google Drive files

Exclude Google file revisions

Exclude Google Docs

Exclude Google Sheets

Exclude Google permissions

  When enabled, you can use filters to exclude content from your migration.
  1. To choose a filter property, click Select 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.
Filter Mail content

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

Setting Enabled by default? Details

Exclude Gmail labels

Exclude Gmail messages

  When enabled, you can use filters to exclude content from your migration.
  1. To choose a filter property, click Select 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.
Filter Contacts content

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

Setting Enabled by default? Details

Exclude Google Contacts

  When enabled, you can use filters to exclude content from your migration.
  1. To choose a filter property, click Select 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.
Filter Calendar content

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

Setting Enabled by default? Details

Exclude Google Calendar

Exclude Google Calendar events

  When enabled, you can use filters to exclude content from your migration.
  1. To choose a filter property, click Select 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.
User mapping
Setting Enabled by default? Details
Map users When enabled, users are mapped according to the identity mapping associated with the bridge.

Note: If you enable this setting, 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 doesn't allow sharing with users outside of the domain, enabling this setting might cause errors.

Domain mapping   When enabled, G Suite 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:
  1. In the Source domain field, enter the source domain.
  2. 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, G Suite Migrate first checks that mapping for a new username. If it doesn’t find a new username, G Suite Migrate uses this setting to generate one.

Migrate My Drive to shared drives

Move to shared drive
Setting Enabled by default? Details
Migrate folders 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 Select either Migrate files or Skip files. If Migrate files is enabled, you can choose to:
  • Migrate revisions (on by default)
  • Migrate Docs (on by default)
  • Migrate Sheets (on by default)
  • Migrate comments (on by default).
  • Migrate Drive files with restricted permissions (off by default)
Migrate folder permissions When enabled, folder permissions are migrated to the target shared drive.

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

Migrate file permissions When enabled, file permissions are migrated.

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

Filter Drive content

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

Setting Enabled by default? Details

Exclude Google Drive folders

Exclude Google Drive files

Exclude Google file revisions

Exclude Google Docs

Exclude Google Sheets

Exclude Google permissions

  When enabled, you can use filters to exclude content from your migration.
  1. To choose a filter property, click Select 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.
User mapping
Setting Enabled by default? Details
Map users When enabled, users are mapped according to the identity mapping associated with the bridge.

Note: If you enable this setting, 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 doesn't allow sharing with users outside of the domain, enabling this setting might cause errors.

Domain mapping   When enabled, G Suite 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:
  1. In the Source domain field, enter the source domain.
  2. 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, G Suite Migrate first checks that mapping for a new username. If it doesn’t find a new username, G Suite Migrate uses this setting to generate one.

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.