About SharePoint settings template options

If you're migrating from OneDrive for Business, follow the instructions for SharePoint unless specified.

You can migrate Microsoft SharePoint content to a user's My Drive 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.

Open all   |   Close all

Migrate to My Drive

Migrate SharePoint content

Migrate site collections to folders

Enabled by default

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

Migrate webs to folders

When enabled, SharePoint webs are migrated to Drive folders.

Migrate lists to sheets

When enabled, SharePoint lists are migrated to Google Sheets in Drive.

Migrate libraries to folders

Enabled by default

When enabled, SharePoint libraries are migrated to Drive folders. You can choose to:

  • Migrate SharePoint folders to Drive folders.
  • Migrate SharePoint documents to Drive files.
  • Migrate SharePoint versions to revisions in Drive. If enabled, you can turn on Pin revisions 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 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 role assignments to Google permissions

Enabled by default

When enabled, role assignments in SharePoint are migrated as permissions in Drive.

You can choose to turn on or turn off:

  • Sharepoint web permissions (on by default)
  • SharePoint library permissions (on by default)
  • SharePoint folder permissions
  • SharePoint document permissions
  • SharePoint list permissions 
  • Inherited 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 SharePoint content

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

Exclude SharePoint site collections

Exclude SharePoint webs

Exclude SharePoint libraries

Exclude SharePoint lists

Exclude SharePoint folders

Exclude SharePoint documents

Exclude SharePoint list items

Exclude SharePoint role assignments

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.

    Note: If you select the SharePoint Object URL filter, use the URL format https://{hostname}/{path to item}.

  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.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
User mapping

Map users

Enabled by default

When enabled:

  • Users are mapped according to the identity mapping associated with the bridge.
  • 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 users outside of the organization, 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:

  • 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, 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 SharePoint to shared drives

Migrate site collections to folders

Enabled by default

When enabled, SharePoint site collections are migrated to shared drive folders.

Migrate webs to folders

When enabled, SharePoint webs are migrated to shared drive folders.

If enabled, you can choose to Migrate SharePoint webs with restricted permissions (off by default). Child webs that have been assigned fewer permissions than the parent (as specified in the mapping) are migrated. If turned off, those webs are skipped.

Migrate lists to sheets

When enabled, SharePoint lists are migrated to Google Sheets in a shared drive. If enabled, you can choose to:

  • Migrate SharePoint lists with 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. 
  • Migrate list items to sheet rows (on by default).

Note: If these settings are turned on, extra sheets are created during the migration process.

Migrate libraries to folders

Enabled by default

When enabled, SharePoint libraries are migrated to shared drive folders. If enabled, you can choose to:

  • Migrate SharePoint libraries with 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.
  • Migrate SharePoint folders to shared drive folders.

Migrate documents to files

Enabled by default

When enabled, SharePoint documents in libraries are migrated to files in shared drives. You can choose to:

  • Migrate SharePoint document metadata to Google Sheets (on by default). This setting creates extra sheets during the migration process. 
  • Migrate SharePoint documents with restricted permissions (off by default).
  • Migrate SharePoint versions to revisions in Drive. If enabled, you can turn on Pin revisions 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 number in the Max pinned revisions field.

Migrate folder permissions

Enabled by default

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 SharePoint content

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

Exclude SharePoint site collections

Exclude SharePoint webs

Exclude SharePoint libraries

Exclude SharePoint lists

Exclude SharePoint folders

Exclude SharePoint documents

Exclude SharePoint list items

Exclude SharePoint assignments

When enabled, you can use filters to exclude content from your migration.

  1. Click Select Property and choose a filter property.
  2. Complete the filter conditions.

    Note: If you select the SharePoint Object URL filter, use the URL format https://{hostname}/{path to item}.

  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.
  6. After you enter all filters, click Create a new template, enter a template nameand thenCreate.
User mapping

Map users

Enabled by default

When enabled:

  • Users are mapped according to the identity mapping associated with the bridge.
  • 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 users outside of the organization, 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:

  • 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, 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

Set up or select 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.

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
false