Understand Box settings templates

You can migrate your content to your users' My Drive (default) 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.

Migrate to users My Drive (Default)

Copy Box content
Setting Enabled by default? Details
Copy folders

When enabled, Box folders are converted to Google Drive folders.

Copy files

When enabled, Box files are converted to Drive files.

Check the Copy versions box to migrate versions of file. To set a limit of how many versions should be migrated as file revisions, enter a numerical value in the Specify max number of pinned revisions field.

Copy collaborations When enabled, Box collaborations are converted to 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
Setting Enabled by default? Details
Filter Box folders

Filter Box content

Map Box location

User mapping

When these settings are enabled, filtering options are turned on.

You can use Boolean search operators to set the filter options. To set multiple filters, click Add filter.

(Optional) Exclude from crawl—Elements excluded by the filter won’t show as transactions during a migration.

(Optional) Exclude children—All children of the filtered object are excluded from the migration.

Map Box locations
Setting Enabled by default? Details
Allow unmapped locations When enabled, all folders under the root folder are migrated, even if they aren’t included in a mapping. If this setting is disabled, only mapped folders and files are migrated.
Create locations

When enabled, Drive folders that currently don’t exist but are specified in the location mapping are created during the migration process.  

(Optional) Use pre-existing locations—Checks to see whether a folder with the same name already exists. If so, a new folder isn’t created.

User mapping
Setting Enabled by default? Details
Map users When enabled, user permissions are copied to Drive folders and files.
Allow unmapped users When enabled, all user permissions are migrated, including users who aren’t specified in the user mapping.

Note: If your organization does not allow sharing with outside users, 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@sourcedomain.com becomes user1@targetdomain.com). 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 to shared drives

Migrate Box to shared drives
Setting Enabled by default? Details
Copy folders When enabled, Box folders are converted to shared drive folders.
Copy files

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

Check the Copy versions box to migrate versions of file. To set a limit of how many versions should be migrated as file revisions, enter a numerical value in the Specify max number of pinned revisions field.

Migrate shared drive permissions When enabled, permissions from the root folder are migrated to the target shared drive.
Migrate additional file permissions When enabled, any additional file permissions are preserved.  
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
Setting Enabled by default? Details
Filter Box folders

Filter Box content

Map Box location

User mapping

When these settings are enabled, filtering options are turned on.

You can use Boolean search operators to set the filter options. To set multiple filters, click Add filter.

(Optional) Exclude from crawl—Elements excluded by the filter won’t show as transactions during a migration.

(Optional) Exclude children—All children of the filtered object are excluded from the migration.

Map Box location
Setting Enabled by default? Details
Allow unmapped locations When enabled, all folders under the root folder are migrated, even if they aren’t included in a mapping. If this setting is disabled, only mapped folders and files are migrated.​
Create locations

When enabled, shared drive folders that currently don’t exist but are specified in the location mapping are created during the migration process.  

(Optional) Use pre-existing locations—Checks to see whether a folder with the same name already exists. If so, a new folder isn’t created.

User mapping
Setting Enabled by default? Details
Map users When enabled, user permissions are copied to shared drive folders and files.
Allow unmapped users When enabled, all user permissions are migrated, including users who aren’t specified in the user mapping.

Note: If your organization does not allow sharing with outside users, 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@sourcedomain.com becomes user1@targetdomain.com). 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.