Important Questions

Which plans support the migration?
All Team plans (Starter, Team, and Business) support the migration. WorkDrive's Individual plan does not support the migration yet. 

Who can manage the migration?

For Google Workspace: Super Admin

For WorkDrive: Admin or Super Admin

How can I start the migration?

1. The Super Admin or an Admin of the WorkDrive account must raise a request for migration.

2. Once we have the required data , we will enable the migration tool in their WorkDrive account. The Super Admin or Admins will be able to see the migration tool in their Admin Console, and they can start the migration from there.

Note : The Super Admin or an Admin who initiates the migration will become our point of contact for all migration-related activities and notifications.

What will happen to my data in Google Workspace Drive after migration?

We don't delete any data during the migration, so all your data in Google Workspace Drive will remain intact afterwards.

Migration Prerequisites

In Google Workspace

Note: It may take some time for the application to be listed after configuration. If not listed immediately, you can manually add the list by the following actions:

1. In the App access control section, click Manage Third-party App Access.
2. Click Configure new app, and select OAuth App Name Or Client ID. This will open the Configure an OAuth app page.
3. In the search box, enter 'Zoho WorkDrive' and click Search.
4. From the options, choose Zoho WorkDrive and click Select.
5. Check the boxes for the client IDs that you want to configure, and then click SELECT.
6. On the next page, choose the access control you want to provide for the client IDs from the following options:
   Trusted: Can access all Google services
   Blocked: Can't access any Google service
   
   
7. Click CONFIGURE.

In Zoho WorkDrive

1. If you forgot to add any Google Workspace users to WorkDrive before the migration, and wish to add them later, you'll need to perform a new migration for those users.
   
   
2. Sharing permissions granted to such users will not be retained on any files and folders migrated earlier.
   

Limitations

General Limitations

1. Each user can only be migrated once per service.
   
   
1. Any data added to Google Workspace Drive post-migration cannot be migrated again to Zoho WorkDrive.
   
   
2. Duplicate entries will not be allowed for migration in both Google Workspace and Zoho WorkDrive. For example, data from multiple Google Workspace accounts cannot be migrated to a single WorkDrive account, and data from a single Google Workspace account cannot be migrated to multiple WorkDrive accounts.
   
   Note: If you wish to move data from one Google Workspace user to another, you can transfer ownership of the user's files before migrating from Google Workspace to WorkDrive. Reference: Transfer ownership of Google Workspace Drive files
   
   
2. External sharing permissions from Google Workspace files and folders will not be retained in Zoho WorkDrive.
   
3. Users from different domains who migrate later will not retain sharing permissions on any files and folders migrated earlier, but sharing permissions on their personal files will be retained for the users migrated earlier.
   
4. If users in Google Workspace did not join or were inactive in Zoho WorkDrive at the time of migrating their shared files or folders, they will no longer have access to those shared files or folders, even after joining or becoming active later in WorkDrive.
   
5. Comments, revision history, and groups will not be migrated.
   
6. File size more than 25 GB will not be migrated.
   
7. Google native files (Docs, Sheets, and Slides) more 10 MB in size will not be migrated.
   
8. A user's deleted and trashed files and folders will not be migrated.
   
9. Files and folders synced to Google Workspace Drive from your computer via Backup and Sync will not be automatically migrated to WorkDrive.
   
   You can move subfolders from the section "Computers" to "My Drive" to migrate them to WorkDrive. To do this, open the folder tree in the left side of Google Drive, then drag and drop the subfolders from "Computers" to "My Drive." Learn more on Google Drive
   
   Note: You cannot move primary folders from "Computers" to your "My Drive."
   
   
10. Mime types like `application/vnd.google-apps.map`, `application/vnd.google-apps.form`, and `application/vnd.google-apps.site` are not supported in WorkDrive—these are primarily Google Maps, Forms, and Sites data respectively.
    
11. A folder cannot contain files with the same name. In such cases, WorkDrive will append filename (1).extn, at the end of the file.
    
12. Filenames without an extension cannot be previewed in WorkDrive.
    
13. When a shared resource is added to a user's My Drive in Google Workspace (through Add to My Drive), that particular file will be migrated to both the file's owner and the shared user. In this case, both will have a copy of the same file.
    
14. Shortcut links in Google Workspace Drive will be stored as a copy in WorkDrive.
    

1. All Shared Drives in Google Workspace will be migrated as private Team Folders in the first migration. You cannot migrate any Shared Drives later.
   
2. Roles of Shared Drives will be replaced with corresponding Team Folder roles in WorkDrive.
   
3. Sharing permissions of individually shared files and folders in Shared Drives will not be retained in WorkDrive.
   
4. At least one member—either admin or member from a Shared Drive—must be mapped to WorkDrive to migrate that Shared Drive to WorkDrive.
   
5. If an admin from Shared Drive is mapped, they will become the admin to the corresponding Team Folder in WorkDrive.
   
6. If only a member of a Shared Drive is mapped, the Shared Drive will be migrated to WorkDrive with the Admin role assigned to the user who has created the migration.
   
7. If no member from a Shared Drive is mapped, the Shared Drive will not be migrated to WorkDrive.
   
8. Deleted Shared Drives will not be migrated to WorkDrive.
   
   

Migration Steps

Important: Before you proceed to the migration steps, make sure you have covered the prerequisites in Google Workspace and WorkDrive.

The WorkDrive migration tool will only be enabled based on a request from an Admin or the Super Admin of that WorkDrive account.

1. To map all users, make sure all users from your Google Workspace account have joined and are active in WorkDrive.
   
   
2. If the email address for a user in WorkDrive is different from their Google Workspace account, then make sure the WorkDrive email address is correctly updated, corresponding to its Google Workspace email address in the CSV file. Refer Update the exported CSV file.
   

Files in Google format (Docs, Sheets, and Slides) will be automatically converted to its corresponding WorkDrive format (Writer, Sheet, and Show).

Files in other formats, such as .docx, .xlsx, and .pptx, will be saved to WorkDrive in their original formats. These files can only be previewed. To edit these files, you'll need to convert them to WorkDrive format (Writer, Sheet, or Show), which will create a copy of the original file.

Know the supported files in WorkDrive here.

1. Which users or Team Folders are being migrated
   
2. Number of files migrated
   
3. Total files
   
4. Size of the migrated files
   

1. You cannot individually select and migrate users or Team Folders.
   
2. Click the Refresh icon on the right side to get the live status of migration.
   

1. Total files
   
2. Migrated files
   
3. Failed files
   
4. Total folders
   
5. Migrated folders
   
6. Failed folders
   
7. Total size
   

Some common failure reasons include:

1. File is marked as spam/virus.
   
2. File is not available in the source service.
   
3. No permission on the file. Contact the file owner for access. 
4. Download restricted in the source service. Contact the file owner for access.

1. The migration report will be uploaded to the My Folders of the user (Admin or Super Admin) who initiated the migration. The report will be saved with the name "Migration report for <Migration name>" and shared with all team admins.
   
   
2. If you have left some users out of this migration, you can create a new migration to migrate those users at any time later.
   

1. For single migration, you must upload the CSV file containing all your users (from exported Google Workspace users or updated Google Workspace users).
   
   For teams with users from different domains, single migration can be the only option to retain share permissions on files and folders. The uploaded CSV file must have all users compiled from the different domains.
   
   
2. For multiple migrations, you must upload a new CSV file for each migration containing only the required users (from exported Google Workspace users or updated Google Workspace users).
   
   You can only create a new migration after the successful completion of a previous migration, (i.e., all mapped users and available Team Folders must be migrated first to create a new migration).

Troubleshooting unmapped users

1. User's email address is invalid: Upload a new CSV file with the corrected email address and try mapping again.
   
   
2. Duplicate entries found for the user: Upload a new CSV file with duplicate entries removed and try mapping again.
   
   
3. Migration already completed for this Zoho/Google Workspace user (email address): Migration cannot be done again for the user.
   
   
4. User is not part of Zoho: Make sure the user has signed up for Zoho and joined WorkDrive, then try mapping again.
   
   
5. User is not a member of this WorkDrive team: Make sure the user is active in your team and try mapping again.
   
   

Role mapping (for reference)