Understand file share settings templates

You can migrate files share content to a user's My Drive (default) or to a shared drive. 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 file content

Setting Enabled by default? Details
Convert folders to folders in Google Drive When enabled, file share folders are copied to Drive.
Convert files to files in Google Drive When enabled, file share files are copied to Drive files.
Convert file permissions to permissions in Google Drive When enabled, file share file permissions are copied to Drive files. You can choose to:
  • Include folder permissions.
  • Include file permissions.
  • Exclude SID named permissions. If you included SID permissions in your mappings, disable this option.
  • Exclude inherited permissions.
Allow email invitations When enabled, users outside of your domain who are assigned permissions for a Drive folder or file are sent an email notification.

Filter file content

Setting Enabled by default? Details

Filter folders

Filter files

Filter permissions

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

Use Boolean search operators to set the filter options. To set multiple filters, click Add filter

  1. To view the available filters, click Select Property to choose a filter property.
  2. Complete the filter conditions. 
  3. (Optional) To set multiple filters, click Add filter and repeat the steps. 
  4. (Optional) To ensure that elements excluded by the filter won’t show as transactions during a migration, check the Exclude from crawl box. 
  5. (Optional) To ensure that children of the filtered object are excluded from the migration, check the Exclude children box.

Map file 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.​

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 domain does not 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@sourcedomain.com becomes user1@targetdomain.com). If enabled:
  • 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, G Suite Migrate first checks that mapping for a new username. If it doesn’t find a new username, G Suite Migrate uses the domain mapping to generate one.

Migrate to shared drives

Migrate files to shared drives

Setting Enabled by default? Details
Convert folders to folders in Google Drive When enabled, file share folders are converted to folders in shared drives. If enabled, you can choose to migrate file share 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. 
  • Restricted permissions (off by default)–If enabled, 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.
Convert files to files in Google Drive When enabled, file share files are converted to files in shared drives. If enabled, you can choose to migrate file share files with:
  • Additional permissions (on by default)–If enabled, child files that have been assigned more permissions than the parent (as specified in the mapping) are migrated. If turned off, those files are skipped. 
  • Restricted permissions (off by default)–If enabled, child files that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those files are skipped.
Migrate shared drives 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 domain who are assigned permissions for shared drives are sent an email notification.

Filter file content

Setting Enabled by default? Details

Filter folders

Filter files

Filter permissions

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

Use Boolean search operators to set the filter options. To set multiple filters, click Add filter

  1. To view the available filters, click Select Property to choose a filter property.
  2. Complete the filter conditions. 
  3. (Optional) To set multiple filters, click Add filter and repeat the steps. 
  4. (Optional) To ensure that elements excluded by the filter won’t show as transactions during a migration, check the Exclude from crawl box. 
  5. (Optional) To ensure that children of the filtered object are excluded from the migration, check the Exclude children box.

Map file 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.

User mapping

Setting Enabled by default? Details
Map users When enabled, user permissions are copied to shared drives.
All unmapped users

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

Note: If your domain does not 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@sourcedomain.com becomes user1@targetdomain.com). If enabled:
  • 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, G Suite Migrate first checks that mapping for a new username. If it doesn’t find a new username, G Suite Migrate uses the domain mapping to generate one.