What is Migrate for AODocs?

Migrate for AODocs is a tool that allows you to migrate files and folders into your AODocs libraries.

Learn more: AODocs overview: Choose an AODocs library

With Migrate for AODocs, you can:

  • preview the file and folder structure before running the migration
  • configure your file and folder data before creating them as AODocs documents and folders
  • define the structure of your migrated files before creating them in AODocs

Automatically generated table of contents

Where can you migrate from with Migrate for AODocs? 

You can migrate data from:

  • File servers
  • Google Drive
  • Google spreadsheets
  • CSV files
  • SharePoint
  • Lotus Notes

Learn more:

What is the Migrate for AODocs process? 

The Migrate for AODocs migration process has the following stages:

Analysis (optional): You can generate a preview of the migration spreadsheet. This lets you analyse the data before the extraction. Learn more: Basic definitions: migration spreadsheets.

1. Extraction: Migrate for AODocs extracts file data and fills in the migration spreadsheet.

2. Validation: Migrate for AODocs checks that your migration is valid. 

3. Upload: Migrate for AODocs completes the extraction and: 

  • uploads data into the Google Drive migration accounts
  • transfers ownership to the AODocs storage account
    Learn more: What is the AODocs storage account?
  • gives migrated files a Google Drive file ID

4. Setup: You can manually configure fields, categories and folders in the migration spreadsheet. Your changes are applied before the documents are created in AODocs.

5. Creation: Create the AODocs documents and folders with the configured data applied. 
Learn more: What is an AODocs document?

6. Report: Migrate for AODocs creates a report. Learn more: View migration reports.

Migrate for AODocs: basic definitions


Migrate for AODocs users can run migrations using their migration accounts. They don't have access to the administration page.


Administrators can run migrations using their migration accounts.

They also have access to the administration page where they can:

Migration accounts

When you perform actions in Migrate for AODocs (such as create and edit the migration spreadsheet) you use your migration account. This is your standard professional email account.

Uploader accounts

Uploader accounts are technical accounts used to to run your migrations. 

Before you use Migrate for AODocs, your Workspace admin must create one or more standard Google Accounts which serve as uploader accounts.

Uploader accounts are used only to upload files into Google Drive because this process may overload the My Drive of your migration account. You mustn’t use your professional accounts to upload documents to Google Drive during the migration process.

Uploader accounts are temporary: when your migration is complete, you can delete them so they no longer consume licenses. 

Workspace admins can install the Migrate for AODocs - Uploader management application, which automatically authorizes all uploader accounts on your domain. This avoids having to explicitly grant permissions for each one. Learn more: Create and authorize uploader accounts.

– You can’t use an uploader account for more than one migration at a time.
– You can use up to five uploader accounts for each professional account.

Tip: Typically, for 100 migrations, you may use two different professional accounts, each with five uploader accounts. This lets you run 50 migrations sequentially for each professional account at the same time.

Migrate for AODocs workspaces

Migrate for AODocs workspaces allow you to organize your migration process according to your business case. Workspaces can be composed of more than one migration. Migrate for AODocs administrators can create Migrate for AODocs workspaces.

For example: You can create one workspace per geographical location (Paris and London). You can then run two separate migrations for the London workspace: one for your local file structure and one for your SharePoint file structure; and run just one SharePoint migration for the Paris migration because you don’t have any local files to migrate.

Extraction and migration spreadsheets

The migration spreadsheet contains the instructions about how to handle your source data during the migration.

You can generate:

  • an extraction spreadsheet, to analyse the details of your source files and extract details about the migration (no migration takes place from the extraction spreadsheet) – learn more: Extract details of your source data and migration setup
  • a migration spreadsheet, containing all the instructions that Migrate for AODocs uses to migrate your files to AODocs

When you generate a migration spreadsheet, your migration starts. You can edit the spreadsheet to configure your migration while your files are uploading to the My Drive of your uploader account. You then confirm when you’re ready to create your files in AODocs.

– There’s no difference between the extraction and migration spreadsheets. They’re generated in exactly the same way, according to the options you select in the configuration screen.
– You can also create migration spreadsheets from scratch.

Batch migration spreadsheets

The batch migration spreadsheet contains the instructions that Migrate for AODocs needs to run a batch migration. Learn more: Configure and run batch migrations.


Gateway is a tool that runs locally during the extraction and upload phases when running the following migration types: 

  • File server
  • CSV
  • SharePoint on premise
  • Lotus Notes

Important: You must install Gateway to run these migration types.

Gateway allows Migrate for AODocs to access the local data that you want to import into AODocs.  Migration can take a long time, so you may want to quit Migrate for AODocs and close Chrome. You can leave Gateway running so your migration continues.

Learn more: Install Gateway

Was this article helpful? 6 out of 6 found this helpful
If you didn’t find what you were looking for, don’t hesitate to leave a comment!
Have more questions? Submit a request



Please sign in to leave a comment.