Box to OneDrive Migration Guide

Overview

This Box to OneDrive Migration Guide shows you how to migrate your Box files and folders to OneDrive for Business using the Cloudiway platform.

What's Migrated

The following items are migrated from Box to OneDrive:

Limitations

The following items are not migrated or have limitations:

• Box Shared Links: Shared links are not migrated and must be recreated in OneDrive.
• Box Comments: File comments are not migrated to OneDrive.
• Box Tasks: Tasks associated with files are not migrated.
• Box Workflows: Box Relay workflows are not migrated.
• Box Integrations: Third-party app integrations are not migrated.
• External Collaborators: External users must be re-invited in OneDrive.

Prerequisites

To perform the Box to OneDrive migration, you need admin access to both platforms.

Box Requirements

Microsoft 365 Requirements

Migration Process

The Box to OneDrive migration follows these steps:

Step 1: Create Connectors

Create connectors for both Box and Microsoft 365.

Box Source Connector

Go to Connectors > New, select Box as connector type and select Files.

Microsoft 365 Target Connector

Create a Microsoft 365 connector for the target OneDrive. Go to Connectors > New, select Microsoft 365 and Files.

Click GRANT ADMIN CONSENT to authorize the Cloudiway application to access your Microsoft 365 tenant.

Step 2: Fill User List

To retrieve or upload your Box users, select the User List tab under the Files product. There are three ways to populate the migration list.

Option 1: Discovery (Get List)

Under MIGRATION, click on the Get List option to discover all Box users:

Select your source Box connector and click GET to start the discovery process. All Box users with their root folders will be listed.

Option 2: CSV Import File

The second way to populate the migration list is to upload a CSV file.

Check this article for generating the CSV file correctly: How to fill the Users/Groups CSV file

Click MANAGE > Import. Select the CSV File, the Source and Target Connectors, then click Upload.

Option 3: Manual Creation

The third way is to manually create an entry. Click the MANAGE tab, and from the drop-down list click Create.

Step 3: Configure Target Location

Configure where Box content will be migrated in OneDrive. For personal file migrations, each Box user's files are migrated to their corresponding OneDrive account.

Assign Target Connector

Select users in the list and from the menu, click on MANAGE, then Assign Target to assign the Microsoft 365 target connector.

Set Target User

The target OneDrive user is typically set automatically based on the mapping table. Verify that each Box user is mapped to the correct OneDrive account.

Step 4: Mapping Table

The mapping table converts Box user emails to Microsoft 365 accounts. This ensures files are migrated to the correct OneDrive accounts and permissions are preserved.

Navigate to Settings > Mapping Table to verify that:

• All Box users have a corresponding Microsoft 365 account
• Email addresses are correctly matched
• External collaborators are mapped if needed

Step 5: Audit

The audit is optional and purely informative. You do not have to run it unless you want to see how many files and folders you have in Box.

This feature reports information about the Source Box account:

• Number of files
• Number of folders
• Total data size

To Audit a Box user, in User List, select it and click MIGRATION > Audit.

Step 6: Preprocessing

The preprocessing step provisions OneDrive accounts for users who haven't accessed OneDrive yet. This ensures the target location exists before migration.

To run preprocessing, select the users and click MIGRATION > Preprocess.

After preprocessing completes successfully:

Step 7: Run Migration

Start the migration to copy Box files to OneDrive.

Migrate to Specific Folder

It is possible to split and reorganize your content during migration.

In particular, you may want to migrate only specific folders or to migrate content to a specific folder. You can refer to the following article to determine how to configure the migration platform for these specific scenarios:

How to migrate files from or to a specific folder

Exclude Folder

If you want to exclude different folders from the migration, enter the Folder ID or Folder Path.

You can get the Folder ID from the URL, you don't need to enter the Folder Path:

Delta Pass

Cloudiway supports delta passes for Box migrations. After the initial migration:

• Only new or modified files since the last migration are copied
• New folders are created
• The platform does not duplicate content

Frequently Asked Questions