About file share settings template options

You can migrate files share 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.

Migrate to My Drive

Expand section  |  Collapse all & go to top

Migrate file share content

Migrate folders to Google Drive	Enabled by default When enabled, file share folders are migrated to Drive.
Migrate files to Google Drive	Enabled by default When enabled, file share files are migrated to Drive files.
Migrate file permissions to Google Drive	Enabled by default When enabled, file share file permissions are migrated 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 inside and outside your organization that are assigned permissions for a Drive folder or file are sent an email notification.

Filter file content

Exclude folders Exclude files Exclude permissions

When enabled, you can use filters to exclude content from your migration. Check the box to select the type of content you want to filter. Click AND, then select And or Or filter logic. Click Select Property and choose a filter property. Complete the filter conditions. String-based filters are not case sensitive unless indicated. (Optional) To create a set of filters, click Add Group and repeat steps 1–4. (Optional) To add another filter, click Add Filter and repeat steps 1–4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box. Excluded objects show as skipped transactions in the transaction log. If you check the box, you won't see excluded objects in the log. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box. After you enter all filters, click Create new template, enter a template nameCreate. For more information, go to Use filters to exclude content (on this page).

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, user permissions on the source domain (including permissions belonging to users that aren’t specified in an identity mapping) are transferred to the files on the new domain. Users with permission to access files and folders on the source domain retain access after the migration. However, the permissions are not transferred to users on the target domain.  Note the following points: If your organization doesn't allow sharing with users outside of the organization, enabling this setting might cause errors. If you want to transfer permissions to the new users on the target domain, use an identity mapping. For details, go to Create & manage an identity mapping.
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

Expand section  |  Collapse all & go to top

Migrate file share to shared drives

Migrate folders to Google Drive	Enabled by default When enabled, file share folders are migrated to folders in shared drives. If enabled, you can choose to Migrate folders with restricted permissions (off by default). 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.
Migrate files to Google Drive	Enabled by default When enabled, file share files are migrated to files in shared drives. If enabled, you can choose to Migrate files with restricted permissions (off by default). 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 folder permissions	Enabled by default When enabled, folder permissions are migrated to the target shared drive. Restricted permissions are not migrated. Go to Restricted permissions.
Migrate file permissions	When enabled, file permissions are migrated. Restricted permissions are not migrated. Go to Restricted permissions.
Allow email invitations	When enabled, users outside of your organization who are assigned permissions for shared drives are sent an email notification.

Filter file share content

Exclude Folders Exclude Files Exclude Permissions

When enabled, you can use filters to exclude content from your migration. Check the box to select the type of content you want to filter. Click AND, then select And or Or filter logic. Click Select Property and choose a filter property. Complete the filter conditions. String-based filters are not case sensitive unless indicated. (Optional) To create a set of filters, click Add Group and repeat steps 1–4. (Optional) To add another filter, click Add Filter and repeat steps 1–4. (Optional) To identify objects that are excluded by your filter, uncheck the Exclude from crawl box. Excluded objects show as skipped transactions in the transaction log. If you check the box, you won't see excluded objects in the log. (Optional) To include children of excluded objects in the migration, uncheck the Exclude children box. After you enter all filters, click Create new template, enter a template nameCreate. For more information, go to Use filters to exclude content (on this page).

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, user permissions on the source domain (including permissions belonging to users that aren’t specified in an identity mapping) are transferred to the files on the new domain. Users with permission to access files and folders on the source domain retain access after the migration. However, the permissions are not transferred to users on the target domain.  Note the following points: If your organization doesn't allow sharing with users outside of the organization, enabling this setting might cause errors. If you want to transfer permissions to the new users on the target domain, use an identity mapping. For details, go to Create & manage an identity mapping.
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.

Use filters to exclude content

Expand section  |  Collapse all & go to top

Exclude folder filters

Property	Example
File path–Network path of the folder If you're migrating from a Microsoft Windows file share, the path is case-sensitive.	To exclude subfolder temp1, enter Equals and then \\DESKTOP\Users\user1\Desktop\file-share-test\temp\temp1. To add a partial folder path, use Folder\SubFolder.
Last accessed–Date in YYYY-MM-DD HH:MM format	To exclude folders that were last accessed after 2022-01-27 00:00, enter After and then 2022-01-27 00:00.
Google Workspace Migrate path–Predicted Google Drive folder path on the target account Separate nested folders with a hash (#). Special characters must be HTML-encoded.	To exclude subfolder test3 that resides in folder test1, enter Contains and then #test1#test3.
Last Modified Date–Date in YYYY-MM-DD HH:MM format	To exclude folders that were modified before 2022-01-27 00:00, enter Before and then 2022-01-27 00:00.
Created Date–Date in YYYY-MM-DD HH:MM format	To exclude folders that were created after 2022-01-27 00:00, enter After and then 2022-01-27 00:00.

Exclude file filters

Property	Example
File size–Size of file (in bytes)	To exclude files that are smaller than 3 bytes, enter Less than and then 3.
File Name–Name of file	To exclude files with the string abc in their file name, enter Contains and then abc.
File Extension–3-letter file extension	To exclude executable files, enter Equals and then exe.
Mime Type–Type of content contained in the file For more information, go to Common MIME types.	To exclude files that contain plain text, enter Contains and then text/plain.
File path–Network path of the file If you're migrating from a Microsoft Windows file share, the path is case-sensitive.	To exclude the file abc.txt, enter Equals and then \\DESKTOP\Users\user1\Desktop\file-share-test\temp\temp1\abc.txt.
Last accessed–Date in YYYY-MM-DD HH:MM format	To exclude files that were last accessed after 2022-01-27 00:00, enter After and then 2022-01-27 00:00.
Google Workspace Migrate path–Predicted Drive file path on the target account Separate nested folders with a hash (#). Special characters must be HTML-encoded.	To exclude the file test.txt that resides in the predicted Drive path #temp#temp1, enter Contains and then #temp#temp1#test.txt.
Last Modified Date–Date in YYYY-MM-DD HH:MM format	To exclude files that were modified before 2022-01-27 00:00, enter Before and then 2022-01-27 00:00.
Created Date–Date in YYYY-MM-DD HH:MM format	To exclude files that were created after 2022-01-27 00:00, enter After and then 2022-01-27 00:00.

Exclude permission filters

Property	Example
Google Workspace Migrate path–Predicted Google Drive file path on the target account Separate nested folders with a hash (#). Special characters must be HTML-encoded.	To exclude permissions associated with the subfolder temp1, enter Contains and then #temp#temp1.
Associated User–Username To find the username, on your Windows machine: Right-click the file and select Properties. Click the Details tab and scroll down to Owner. Next to Owner, copy the username.	To exclude permissions associated with user1, enter Equals and then DOMAIN\user1.

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.}