Understand Box settings templates

You can migrate Box® 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 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.
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@ 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 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.

If enabled, you can choose to migrate Box folders with additional permissions (on by default). If enabled, child folders that have been assigned more permissions than the parent (as specified in the mapping) are migrated. If turned off, those folders are skipped.

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 permissions held by the file (that aren’t held by its parent) are migrated.
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 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.
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@ 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.