Understand SharePoint settings templates

You can migrate Microsoft® SharePoint® 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 SharePoint content
Setting Enabled by default? Details
Convert site collections to folders

When enabled, SharePoint site collections are converted to Google Drive folders.

Convert webs to folders When enabled, SharePoint webs are converted to Drive folders.
Convert lists to sheets When enabled, SharePoint lists are converted to Google Sheets in Drive.
Convert items to sheet rows When enabled, items in a SharePoint list are converted to rows in Sheets in Drive.
Convert libraries to folders When enabled, SharePoint libraries are converted to Drive folders. You can choose to:
  • Convert SharePoint folders to Drive folders.
  • Convert SharePoint documents to Drive files.
  • Convert SharePoint versions to revisions in Drive. If enabled, you can turn on Version pinning amount and:
    • To attach Drive's Keep forever tag to the major (not minor) revisions, check the Pin major versions only box.
    • To set a limit of how many revisions should have Drive's Keep forever tag attached, enter a numerical value in the Specify max number of pinned revisions field.
Convert role assignments to Google permissions When enabled, role assignments in SharePoint are converted to permissions in Drive.

You choose to enable:

  • Sharepoint web permissions
  • SharePoint library permissions
  • SharePoint folder permissions
  • SharePoint document permissions
  • SharePoint list permissions
  • Inherited permissions
Allow email invitations When enabled, users outside of your domain that are assigned permissions for a Drive folder or file are sent an email notification.
Filter SharePoint content
Setting Enabled by default? Details
Filter SharePoint site collections

Filter SharePoint webs

Filter SharePoint libraries

Filter SharePoint lists

Filter SharePoint folders

Filter SharePoint documents

Filter SharePoint document versions

Filter SharePoint list items

Filter SharePoint assignments

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 SharePoint URLs to 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.
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 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 SharePoint content to shared drives
Setting Enabled by default? Details
Convert site collections to folders When enabled, SharePoint site collections are converted to shared drive folders.
Convert webs to folders When enabled, SharePoint Sites are converted to shared drive folders. If enabled, you can choose to migrate SharePoint Sites with:
  • Additional permissions (on by default)–If enabled, child documents 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 documents that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those files are skipped.
Convert lists to sheets When enabled, SharePoint lists are converted to Google Sheets in a shared drive. If enabled, you can choose to:
  • Migrate SharePoint lists with:
    • Additional permissions (on by default)–If enabled, child lists 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 lists that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those files are skipped. 
  • Convert list items to sheet rows (on by default).
Note: If these settings are turned on, extra sheets are created during the migration process.
Convert libraries to folders When enabled, SharePoint libraries are converted to shared drive folders. If enabled, you can choose to:
  • Migrate SharePoint libraries with:
    • Additional permissions (on by default)–If enabled, child libraries 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 libraries that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those files are skipped.
  • Convert SharePoint folders to shared drive folders.
Convert documents to files When enabled, SharePoint documents in libraries are converted to files in shared drives. You can choose to:
  • Convert SharePoint document metadata to Google Sheets (on by default). This setting creates extra sheets during the migration process. 
  • Migrate SharePoint documents with additional permissions (on by default) or restricted permissions (off by default).
  • Convert SharePoint versions to revisions in shared drives. If enabled, you can turn on Version pinning amount and to attach Drive's Keep forever tag to the major (not minor) revisions, check the Pin major versions only box. To limit the number of 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 domain who are assigned permissions for shared drives are sent an email notification.
Filter SharePoint content
Setting Enabled by default? Details
Filter SharePoint site collections

Filter SharePoint webs

Filter SharePoint libraries

Filter SharePoint lists

Filter SharePoint folders

Filter SharePoint documents

Filter SharePoint document versions

Filter SharePoint list items

Filter SharePoint assignments

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 SharePoint URLs to 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.​
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 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 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.