Migrate your data from Google Workspace Drive to Zoho WorkDrive

Migrate from Google Workspace Drive to Zoho WorkDrive

With Zoho WorkDrive's improved file management and collaboration, teams can work together more efficiently. If you're currently using Google Workspace (formerly G Suite) Drive and want to migrate your data to Zoho WorkDrive, this migration guide will help.

Important Questions

Which plans support the migration?
For WorkDrive: All WorkDrive Team plans (Starter, Team, and Business) support the migration. WorkDrive's
Individual plan does not support the migration. 
For Google Workspace: All Google Workspace business plans (Business Starter, Standard, and Plus), Enterprise plan, and G suite legacy free plan support the migration.

Who can manage the migration?
For Google Workspace: Super Admin
For WorkDrive: Admin or Super Admin

How can I start the migration?
The Super Admin or an Admin of the WorkDrive account can start the migration by themselves from Admin Console.

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.

What's migrated

  1. All data from your My Drive and Shared Drives will be migrated.

  2. Share permissions of individually shared files and folders from your My Drive will be retained.

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

  4. All Shared Drives in Google Workspace will be migrated as private Team Folders in the first migration. You cannot migrate any Shared Drives later.

  5. Roles of Shared Drives will be replaced with corresponding Team Folder roles in WorkDrive.

  6. At least one member—either admin or member from a Shared Drive—must be mapped to WorkDrive to migrate that Shared Drive to WorkDrive.

    If an admin from Shared Drive is mapped, they will become the admin to the corresponding Team Folder in WorkDrive. 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.

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. Migrating your data to WorkDrive is not possible if there are more than 400,000 (4 lakh) folders, including subfolders, per user in your Google Workspace account.
  3. External sharing permissions from files and folders will not be retained in Zoho WorkDrive.
  4. 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.
  5. 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.
  6. Comments, revision history, and groups will not be migrated.
  7. File size more than 25 GB will not be migrated.
  8. Google native files (Docs, Sheets, and Slides) more 10 MB in size will not be migrated.
  9. A user's deleted and trashed files and folders will not be migrated.
  10. 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."

  11. 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.
  12. A folder cannot contain files with the same name. In such cases, WorkDrive will append filename (1).extn, at the end of the file.
  13. Filenames without an extension cannot be previewed in WorkDrive.
  14. If you've created shortcut links for a file or folder in multiple locations within your Drive account, the file or folder alone will be migrated to one of the locations in a random manner. Shortcut links will not be migrated.

Shared Drive Limitations

  1. Sharing permissions of files and folders in Shared Drives will not be retained.
  2. If no member from a Shared Drive is mapped, the Shared Drive will not be migrated to WorkDrive.
  3. Deleted Shared Drives will not be migrated to WorkDrive.



Migration Prerequisites

To initiate the migration process, you'll need to first complete a few actions in Google Workspace and WorkDrive.

In Google Workspace

i) Create your own Google Cloud app

Users can create their own app or API client with Google to get access to data in Google services like Workspace Drive. This app or client can be used to access and migrate data from Workspace Drive to WorkDrive.
  1. Go to console.cloud.google.com.
  2. Click the Activate cloud shell  icon.



  3. Click CONTINUE.
  4. Copy-paste the following code and press Enter.

    wget -cO - https://workdrive.zohoexternal.com/external/0169e2af0f56be8c78ebabc6830b56bbbc0f56ddf9b55e11177f07f4c0860160/download?directDownload=true > "gcp_app_creator.sh";sh gcp_app_creator.sh

    This will transfer the WorkDrive file (Google app script) to the Google Cloud platform and execute it.

  5. Type a unique project ID and press Enter. You'll get an error message if the project ID you specified was already taken.
  6. Click AUTHORIZE. Once the authorization is done, you'll be shown a download dialog.
  7. Click DOWNLOAD to download the .p12 extension file.

ii) Get a service account email address and OAuth 2 Client ID

  1. Go to console.cloud.google.com.
  2. Click on the Select a Project button/current project name at the top of the page.
    Select a project dialog box will appear.

  3. Navigate to the All tab and select your Project ID (The project ID you entered when creating your Google Cloud app).
  4. Click the Hamburger   icon in the top-left corner.
  5. Select IAM & Admin > Service Accounts.
  6. Select the required service account for your project.
  7. Copy the service account email address and OAuth 2 Client ID.

iii) Manage domain-wide delegation

Authorize the service account to access your organization data without your users having to give their consent individually.
  1. Visit admin.google.com.
  2. Go to Security > Access and data control > API controls.
  3. Under Domain wide delegation, select MANAGE DOMAIN WIDE DELEGATION.
  4. Click Add new to add a new client ID.
  5. Paste the OAuth 2 Client ID of the service account taken from the service account.
  6. Add the scopes (comma-separated) given below:

    https://www.googleapis.com/auth/admin.directory.user.readonly,
    https://www.googleapis.com/auth/drive,
    https://www.googleapis.com/auth/spreadsheets,
    https://www.googleapis.com/auth/userinfo.profile

  7. Click AUTHORIZE.

iv) Export Google Workspace users

  1. From your Google Admin portal, go to Users.
  2. At the top of the Users list, click Download users.
  3. Choose to download all users.
  4. Download the users list as a CSV file.
    Reference: https://support.google.com/a/answer/7348070?hl=en

v) Update the exported CSV file

If you wish to map some Google Workspace users with different email addresses or users to WorkDrive, follow the steps below:
  1. Open the CSV file exported from Google Workspace in a spreadsheet app.
  2. Copy the Email Address column and paste it in a new column at the end.
  3. Name the new column's header as " WorkDrive Email Address ".
  4. Make necessary changes in the column, like the change of domain name or user name in the corresponding users' email address field.
  5. Save the changes and download the file to your computer in CSV format.



In Zoho WorkDrive

vi) Invite Users to WorkDrive

Only active users in WorkDrive can be migrated. An active user is the one who has joined a WorkDrive account and is not in a suspended or deleted state.

The Super Admin or the Admins in WorkDrive must invite all or required Google Workspace users from the exported Google Workspace users or updated Google Workspace users list in the CSV file, respectively, to join their WorkDrive account.

  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.

Migration Steps

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

1. Log in to your WorkDrive account as an Admin or the Super Admin.

2. Click Admin Console in the bottom-left corner of your WorkDrive account.
The Admin Console page will open in a new tab. Dashboard will be selected by default.

3. Click the Migration tab in the left panel to open the Migration screen.

4. Under Google Workspace, click Migrate From Google Workspace. A new screen will open.



5. Under Migration Details, enter a migration name for reference.

6. Enter the service account email address. This is the email address of your service account in Google Cloud (IAM & Admin > Service Accounts).

7. Enter the Google Workspace super admin email address.

8. Import the downloaded .p12 file. This is also known as the service account key, which is used to authenticate with Google APIs. 



9. Click CONTINUE.

10. Click Browse to import the required CSV file containing the exported Google Workspace users or updated Google Workspace Users list.

11. Click CONTINUE to open a new screen for user details. The Mapped Users tab will be displayed by default. You can view the list of users from Google Workspace and their corresponding WorkDrive details.



Click the Unmapped Users tab to see a list of any unmapped users, along with their reasons.

  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.

12. Click PROCEED . A new screen for Migration Settings will open.

13. To migrate sharing permissions on files and folder, check Enable sharing data to migrate . Uncheck it if you don't want to migrate the sharing data. Remember, this setting cannot be changed later.

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.


14. Mark the required checkbox to send an email just to yourself or to all members once the migration is completed, then click CONTINUE . A new screen will open.



15. Select Users or Team Folders , then click START MIGRATION.

All mapped users from the imported CSV file or all Team Folders in your team will be automatically selected for migration.

You will see the status of migration on your screen as it happens. This includes:
  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.

Click View report next to a user's or Team Folder's migration status. (The report link will appear once their migration is complete.)

The user's or Team Folder's report will show you the following:
  1. Total files
  2. Migrated files
  3. Failed files
  4. Total folders
  5. Migrated folders
  6. Failed folders
  7. Total size
In case any files have failed to migrate, they will be listed under Migration Failures. You can view the file name, its Google Workspace link, and the failure reason.



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.

Select the required files and click RETRY FAILED FILES. Alternatively, you can manually download these files from Google Workspace Drive and upload them to WorkDrive.

Once migration is completed for all users and Team Folders, you can download the overall migration report.



Click DOWNLOAD OVERALL REPORT at the top of the page.

The migration report will give you a complete log of the migration activities.

  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.

Click Create New Migration at the top-right corner and follow the same steps from 5 to 17 given above.

You can switch between migrations you have done so far by clicking the respective migration name at the top of the page.

  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

Here are the usual reasons for users being unmapped and their fixes:
  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)

Know the different types of folders and roles available in Google Workspace Drive and Zoho WorkDrive. This will help you use WorkDrive well after you migrate from Google Workspace Drive.

Roles
Google Workspace Drive
Zoho WorkDrive
File Access
Owner
Owner

Edit
Share/Edit

Comment
View and comment

-
View and fill

View
View
Folder Access
Owner
Owner

Organize, add, and edit
Organize/Edit

View
View
Shared Drive/Team Folder Roles
Manager
Admin

Content Manager
Organizer

Contributor
Editor

Commenter/Viewer
Viewer
Team Roles
Super Administrator
Super Admin

Administrator
Team Admin

Member
Team Member

If you have any questions or experience any trouble in your migration process, please contact WorkDrive support for more details.

WorkDrive support info:
  1. EU region: support@eu.zohoworkdrive.com
  2. All other regions: support@zohoworkdrive.com

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                    Manage your brands on social media

                                      Zoho Desk Resources

                                      • Desk Community Learning Series


                                      • Digest


                                      • Functions


                                      • Meetups


                                      • Kbase


                                      • Resources


                                      • Glossary


                                      • Desk Marketplace


                                      • MVP Corner


                                      • Word of the Day


                                        Zoho Marketing Automation

                                          Zoho Sheet Resources

                                           

                                              Zoho Forms Resources


                                                Secure your business
                                                communication with Zoho Mail


                                                Mail on the move with
                                                Zoho Mail mobile application

                                                  Stay on top of your schedule
                                                  at all times


                                                  Carry your calendar with you
                                                  Anytime, anywhere




                                                        Zoho Sign Resources

                                                          Sign, Paperless!

                                                          Sign and send business documents on the go!

                                                          Get Started Now




                                                                  Zoho TeamInbox Resources



                                                                          Zoho DataPrep Resources



                                                                            Zoho DataPrep Demo

                                                                            Get a personalized demo or POC

                                                                            REGISTER NOW


                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now







                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.



                                                                                                  • Related Articles

                                                                                                  • Migrate data from Google Drive to Zoho WorkDrive (using Google Takeout)

                                                                                                    If you want to migrate your data from Google Drive (personal edition) to Zoho WorkDrive, you can consider using Google's Takeout feature ( https://takeout.google.com/ ) to download your data, then upload the data to WorkDrive. We do not provide any ...
                                                                                                  • How to migrate large data from a computer to WorkDrive using Desktop Sync

                                                                                                    If you have to migrate Terabytes (TB) of data from your computer to WorkDrive , then knowing the best migration practices will help you save a lot of time and work. 1 TB = 1024 GB Always use Desktop Sync for WorkDrive to migrate large data from a ...
                                                                                                  • Migrate from Dropbox to Zoho WorkDrive

                                                                                                    If you want to migrate your data from Dropbox Business to Zoho WorkDrive, you can make use of our built-in migration tool . We only support migration for Dropbox Standard, Advanced and Enterprise plans, not for Dropbox personal plans. Similarly, we ...
                                                                                                  • Migrate from OneDrive to Zoho WorkDrive

                                                                                                    If you want to migrate your data from Microsoft OneDrive to Zoho WorkDrive, you can make use of our built-in migration tool. Plan requirements 1. Microsoft OneDrive Migration is currently supported for the following Microsoft plans: Microsoft 365 ...
                                                                                                  • Import users from Google Workspace to WorkDrive

                                                                                                    The Zoho WorkDrive application in Google Workspace Marketplace will help you import Google Workspace (formerly known as G-Suite) users directly into your Zoho WorkDrive account. Steps to import users from Google Workspace account to WorkDrive: Sign ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace

                                                                                                      Resources

                                                                                                      Videos

                                                                                                      Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                      eBooks

                                                                                                      Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                      Webinars

                                                                                                      Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.



                                                                                                        Zoho Show Resources