Understand Box settings templates

You can migrate Box content to your users' 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. See below for details about the templates.

Open all   |   Close all

Migrate to My Drive

Migrate Box content
Setting Enabled by default? Details
Migrate folders ✔

When enabled, Box folders are migrated to Google Drive folders.
Migrate files ✔

When enabled, Box files are migrated to Drive files.

Check the Migrate versions box to migrate versions of file. To limit the number of revisions that are marked with Drive’s Keep forever tag, enter a number in the Max pinned revisions field. The tag is applied to the specified number of revisions, beginning with the most recent.
Migrate collaborations ✔ When enabled, Box collaborations are migrated as Google permissions. 
Allow email invitations   When enabled, users outside of your organization that are assigned permissions for a Drive folder or file are sent an email notification.
Filter Box content

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

Setting Enabled by default? Details
Exclude Box folders

Exclude Box versions

Exclude Box collaborations

 

  

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 does not allow sharing with outside users, 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:
  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, 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 to shared drives

Migrate Box to shared drives
Setting Enabled by default? Details
Migrate folders ✔

When enabled, Box folders are migrated to shared drive folders.
Migrate files ✔

When enabled, Box files webs are migrated to shared drive files.

Check the Migrate versions box to migrate versions of file. To limit the number of revisions that are marked with Drive’s Keep forever tag, enter a number in the Max pinned revisions field. The tag is applied to the specified number of revisions, beginning with the most recent.
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.
Allow email invitations   When enabled, users outside of your organization who are assigned permissions for shared drives are sent an email notification.
Filter Box content

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

Setting Enabled by default? Details
Exclude Box folders

Exclude Box versions

Exclude Box collaborations

  

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 does not allow sharing with outside users, 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:
  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, 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

Use 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.