Migrating SharePoint Document Libraries

Claude Morings Jr

Updated October 09, 2023 11:40

This article explains how to migrate SharePoint Online Document Libraries to Microsoft 365 and Google Workspace.

Migrating to Microsoft 365

SharePoint Online allows for multiple document libraries to be created within one SharePoint site. CloudM will need to be configured differently depending on whether you wish to migrate all document libraries or not.

It is not possible to migrate a specific folder only within a SharePoint Document Library.

Migrating all Document Libraries within one SharePoint Site to a SharePoint Site

When migrating all document libraries to Microsoft 365, Migrate will operate as below.

Migrate will check the destination for a library that exists with the same name as the source. If a match is found, folders/files for this library will be migrated.
If no match is found based on the library title, this library will be created and folders/files migrated to the newly created library.

We will use the below sites as an example.

Source: https://source.sharepoint.com/sites/testsite
Destination:https://destination.sharepoint.com/sites/testsite

To migrate all document libraries within the above source SharePoint site to the destination SharePoint site, you will need to add this item to Step 3 as below.

Export Type: Team Site
Export Name: https://source.sharepoint.com/sites/testsite
Import Type: Team Site
Import Name: sites/testsite
Given Name: Documents
Family Name: Test Site

Family Name will be the display name of the destination SharePoint site. If this already exists, the Family Name can be left blank.

Migrating a single Document Library within a SharePoint Site to a SharePoint Site

When migrating a single document library to Microsoft 365, Migrate will operate as below.

Migrate will check the destination for a library that exists with the same name as the source. If a match is found, folders/files for this library will be migrated.
If no match is found, the migration will fail.

If migrating a document library other than “Documents”, you will need to pre-provision the destination site and document library.

We will use the below sites and document library as an example.

Source: https://source.sharepoint.com/sites/testsite
Source Document Library: TestLibrary
Destination: https://destination.sharepoint.com/sites/testsite

To Migrate the above document library to the corresponding document library at the destination site, you will need to add this item to Step 3 as below.

Export Type: Team Site
Export Name: https://source.sharepoint.com/sites/testsite
Import Type: Team Site
Import Name: sites/testsite
Given Name: TestLibrary
Document Path: TestLibrary

In this case, the site must already exist, therefore Family Name is not required.

Migrating to Google Workspace

When migrating Document Libraries to Google Workspace, the most common scenario is to migrate the document libraries within each site to a Google Shared Drive at the destination. Below, we explain how to do this.

Migrating all Document Libraries within one SharePoint Site to a Google Shared Drive

When migrating all document libraries to Google Workspace, Migrate will operate as below.

The first folder will be the title of the source document library and the contents will contain any folders/files.
Each document library will have it’s own folder in the destination.

We will use the below site and Shared Drive as an example.

Source: https://source.sharepoint.com/sites/testsite
Destination: Test Shared Drive

To migrate all document libraries to the above Shared Drive, you would add the item to Step 3 as below.

Export Type: Team Site
Export Name: https://source.sharepoint.com/sites/testsite
Import Type: Shared Drive
Import Name: Test Shared Drive

The above will migrate all document libraries within the source SharePoint site to the Shared Drive at the destination.

If the shared drive already exists at the destination, you can specify the ID as the import name instead of the Shared Drive ID. If the Shared Drive does not exist, you will need to ensure you have enabled Create Users/Resources/Groups/Shared Drives in Step 2 - Advanced Settings - User.

Migrating a single Document Library within one SharePoint Site to a Shared Drive

When migrating a single document library to Google Workspace, Migrate will operate as below.

The first folder will be the title of the source document library and the contents will contain any folders/files.

We will use the below Site, Document Library and Shared Drive as an example.

Source: https://source.sharepoint.com/sites/testsite
Document Library: TestLibrary
Destination: Test Shared Drive

To migrate this specific document library to the destination Shared Drive, you would add the item to Step 3 as below.

Export Type: Team Site
Export Name: https://source.sharepoint.com/sites/testsite
Import Type: Shared Drive
Import Name: Test Shared Drive
Document Path: TestLibrary
Family Name: Test Shared Drive

Family Name will be the display name of the destination Shared Drive. If this already exists, the Family Name can be left blank.

Permissions

CloudM will migrate direct access permissions on files and folders within the document libraries.
Site level permissions are not migrated.
You will need to ensure you have configured your address replacements correctly for the permissions to be migrated successfully.

How are permissions mapped to Google Shared Drives?

When migrating to Google Shared Drives, permissions will be mapped as below.

SharePoint Online	Google Workspace
Full Control	Manager
Design	Content Manager
Edit	Content Manager
Contribute	Contributor
Read	Viewer
Restricted View	N/A