Steps for IMAP to Google Workspace Migration

Follow step by step guide to Migrate any IMAP Server Account to Google Workspace (G Suite) by SysTools Migrator

Pre-Requisites

Note: Before starting the migration please make sure about the destination domain name(e.g., @domain.com, @domain.onmicrosoft.com, or hosted domains), as this cannot be changed later, because the software licenses will be consumed and these cannot be revoked afterwards.

Following are the Steps to Perform IMAP to Google Workspace Migration

Download and Launch the migration tool.

In case, tool is not activated, see how to activate the product: Activation Steps

Click the "?" Help icon in the bottom left corner to expand the sidebar. Review the prerequisites and carefully read the setup instructions before starting your project configuration.

Help Bar

To enable advance settings for Concurrent migration (optional). Read more: Advance Settings

STEP 1

On the "Setup" screen, select "IMAP" as your Source platform and "G Suite" as your Destination platform to define the migration endpoints.

Endpoint Selection

STEP 2

Scroll down to the Workload selection section. Check the boxes for the specific data types you wish to migrate (e.g., Emails). Unchecked workloads will be completely ignored during the transfer.

Workload Selection

If you only want to migrate data created or received within a specific timeframe, check the "Date Filter" box and set your "From" and "To" dates using the calendar interface.

Date Filter

STEP 3

Click on the "Source" tab on the left-hand navigation pane to configure the authentication for your origin IMAP account.

Source Tab

Select your desired IMAP server from the dropdown menu provided. If your server is not listed, select "Other".

Select IMAP Server

Enter your exact IMAP Host address and Port number. Below is a helpful reference table showing the required IMAP settings for Zoho and other major providers:

Email Provider IMAP Server Hostname Port
Zoho Mail imap.zoho.com / imap.zoho.in / imap.zoho.eu 993
Gmail / G Suite imap.gmail.com 993
Yahoo Mail imap.mail.yahoo.com 993
Outlook / Hotmail outlook.office365.com 993
AOL Mail imap.aol.com 993

IMAP Server Details

If you select Zoho as the source, verify the IMAP server URL in your Zoho Mail admin console.

If the IMAP server URL is imappro.zoho.com, select Zoho Mail from the drop-down menu.

If the IMAP server URL is different, such as imappro.zoho.in, imappro.zoho.eu, or others (as shown below in the red box), follow these steps:

scan partition

Once your Host Name and Port No are accurately filled, click "Validate" to test the IMAP connection.

Validate IMAP Settings

Ensure that all required Read permissions have a green checkmark indicating successful validation. Click "Next".

Source Validation Complete

STEP 4

Click on the "Destination" tab on the left-hand navigation pane to configure the authentication for your target Google Workspace account.

Destination Tab

Enter the Destination Admin Email and upload the Service Account p12/json key file required to authenticate your Google environment. Click "Validate".

Destination Details

Review the Permissions Checklist to ensure all required Write permissions display a green checkmark. Click "Next".

Destination Permissions

STEP 5

Navigate to the "Users" tab. Because IMAP servers do not allow automatic user-fetching, you must map your users using a CSV file. Select "Download Template".

User Mapping Options

A prompt will appear confirming your intent to download a blank CSV structure. Click "Download Template".

Download Template

Choose a local directory on your computer, verify the filename, and click "Save".

Save Template

Open the downloaded CSV in Excel. Fill out the "Source User", "Destination User", and any required password/App Password columns line by line to map the accounts, then save your changes.

Edit Template

STEP 6

Go back to the software and click the "Import Users" button to safely upload your finalized CSV mapping file.

Import Users Option

In the Import Users dialog window, click the small upload (arrow) icon inside the text field to trigger your system browser.

Import Box

Browse your computer to locate your saved mapping CSV, select it, and click "Open".

Browse CSV

With the file successfully selected, click the blue "Upload" button to pull the mapped data directly into the tool.

Upload Mapping

Once processing is complete, a success prompt will tell you exactly how many users were safely imported. Click "OK".

Upload Complete

STEP 7

Review the list of users populated on the screen. Select the users you wish to migrate using the checkboxes on the left.

User List

Once your final selection is made, click the Validate button at the top right of the grid to verify the endpoint credentials and permissions for each account.

Validate Users

Once the system performs the backend check, click "OK" on the success prompt.

Validation Complete

STEP 8

Verify that both the Source and Destination permission columns are glowing green. Click the Start Migration button to proceed.

Start Migration Button

Review the final confirmation prompt detailing the selected items. Click "Start" to initiate the transfer.

Confirm Start

A prompt will inform you that the background execution job has successfully kicked off. Click "OK" to transition to the monitoring dashboard.

Migration Initiated

STEP 9

The application will automatically shift to the "Migration" tab where you can monitor the ongoing process via the intuitive visual dashboard.

Dashboard Overview

Monitor the gray "Pending" card to see which selected accounts are currently queued up and waiting for processing resources.

Pending List

Watch the blue "In-Progress" card to track live, real-time item counts transferring for the active accounts.

In-Progress List

Check the green "Completed" card to verify accounts that have reached 100% successful migration status.

Completed List

STEP 10 (Stop Migration)

If an emergency halt is required during the active process, click the red Stop Migration button located at the top right of the dashboard.

Stop Migration

Confirm your intent to halt the process by clicking Yes in the warning pop-up.

Stop Confirm

Click OK on the success prompt acknowledging that the job has been safely halted.

Process Stopped

STEP 11
  • Retry Failed Items: To migrate the data which didn't get migrated in the first attempt.
  • Re-Run Full Migration: To perform the entire migration process again.
  • Delta Migration: To migrate the newly arrived data in between the migration process.

Click the "Migration Actions" dropdown menu at the top right to access post-job features such as Delta, Retry, and Re-Run.

Migration Actions

Select "Retry Failed Items" to exclusively re-migrate emails that registered as failures on the first pass.

Retry Failed Items

Select "Re-Run Full Migration" to execute a complete, overwrite-style migration over the existing data.

Re-Run Full

Select "Delta Migration" to seamlessly migrate only the newly created items that have arrived since your initial base migration.

Delta Migration

STEP 12

To prepare a customized list for Delta or Retry actions, click the cloud icon to securely download the currently selected "Resource List" into a CSV.

Download Resource List

Pick a location on your computer and click "Save" to retain your exported Resource List.

Save Resource List

Open the CSV in Excel. You can toggle the 'MarkForExecution' column to easily update which accounts should be processed.

Edit Resource List

STEP 13

Alternatively, click the document template icon to download a clean spreadsheet if you need to create a fresh execution list from scratch.

Download Action Template

Important Note on CSV Imports: When you use a CSV list to import and select accounts for post-migration actions (Delta, Retry), the CSV will retain the original TRUE/FALSE checked/unchecked criteria assigned at the time of the initial user selection phase.

To ensure you don't re-run accounts unnecessarily, you must update the list accurately: Go back to the main grid, uncheck the specific accounts you do not want to process, click the cloud icon to download a new Resource List CSV, and upload that newly updated file here.

In the action dialog, click the Import CSV icon to upload your finalized batch of users for processing.

Import CSV

Click the upload arrow icon inside the text field to browse your computer.

Browse CSV

Select your saved CSV from your local directory and click "Open".

Open CSV

Click "Upload" to inject the verified target list into the Delta/Retry configuration window.

Upload Action CSV

Click "OK" once the final processing prompt appears to acknowledge the updated list.

Upload CSV Complete

Click the "Close" button once your list has been processed to return to your operations.

Close Actions Modal

STEP 14

Once your migration is fully completed, click the "Download Report" menu at the top right and select "Migration Summary Report".

Select Summary Report

Choose a location on your computer, and click "Save".

Save Summary Report

Open the generated CSV to see a high-level summary table showing total item success/fail metrics summarized per account.

View Summary Report

STEP 15

If you selected "Detailed Report" instead, check the boxes for the specific accounts you wish to audit, and click the "Download" icon in the dialog box.

Detailed Report Options

Once the system finishes compiling the comprehensive and potentially heavy logs, click the blue "Download" button to save them to your machine.

Download Detailed Report

Choose a safe location and save the compressed `.zip` file containing all the comprehensive CSV reports.

Save Detailed ZIP

Extract the `.zip` file using Windows or a utility tool. Open the specific categorized CSVs to see deep granular transfer data.

Unzip and View Details

STEP 16

To tweak backend performance, navigate to "Settings" > "General". You can check "Enable multiple accounts" and adjust the slider to increase "Concurrent user" processing speed depending on your available bandwidth. Click "Save".

General Settings

Switch to the "Logs" tab to securely view real-time system executions and application health. Select a `.log` file to read exact backend system states.

Logs Settings

STEP 17

Switch to the "SMTP" tab. You must check the Enable email notification box, input your server configurations, and hit Test Connection.

SMTP Settings

Switch to the "Notifications" tab. Important: The notification features in this tab only appear and function when the user successfully checks the "Enable email notification" box in the SMTP tab prior to this step. Craft your email template, hit "Send Test Email" to verify delivery, and click "Save" to finalize your automated reporting logic.

Notification Settings

Free Download SysTools IMAP to G Suite Migrator Download Now