File migration copies files and other related data from your Microsoft OneDrive business editions to your organizations’ Google Workspace users’ My Drive accounts. File migration doesn’t delete or modify existing Google Workspace or OneDrive files or folders, but not all features in OneDrive are supported. Review the table below for details.
Migrated features & data
Files are migrated in their existing format. For example, a PDF will migrate as a PDF.
- Writer
- Reader
- Reviewer
- Can’t download
Specific user & group permissions on files
Editor maps to:
- Writer
Viewer maps to:
- Reader
- Reviewer
- Can’t download
- Writer
- Reader
- Can’t download
Editor maps to:
- Writer
Viewer maps to:
- Reader
- Can’t download
An item in OneDrive can have multiple sharable Anyone links.
An item in Google Workspace can only have one sharable link labeled Anyone with the link . When multiple links to the same item are migrated, we use the most restrictive sharing setting.
For example, if a OneDrive link is shared with Writer and Reader permissions, the link will migrate to Google Workspace with Viewer permission.
People in your organization links
Domain-based link permission
In the case of multiple links, Google Workspace uses the most restrictive sharing setting.
For example, if a OneDrive link is shared with Writer and Reader permissions, the link will migrate to Google Workspace with Viewer permission.People you choose links
Added as direct user permission with the highest role selected in case of multiple links on a user or group.
External users do not have to be included in the identity map.
Document links inside documents
Unchanged
What's not migrated?
- Files and folders with Restricted permissions. Learn more
- Files and folders with Blocked Download policies in Microsoft OneDrive
- Files and folders created by external users
- Files filtered by migration settings (these are shown in the skipped count)
- Versions and metadata of files or folders that were last modified by external users
- Previous versions of files (only the latest version of a file is migrated)
- Permissions for internal users and groups that aren’t present in your Identity map
- Custom permission roles (these are migrated as standard roles)
- OneDrive Personal Vault files
- OneDrive Favorites
- OneDrive folder shortcuts
- OneDrive folder colors
- OneDrive document expiration dates
Migrating to a shared drive is not supported, and the same data cannot be migrated to multiple accounts within the same migration. The data migration tool does not support one-to-many identity mapping.
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.

