Google Workspace: How to Import Messages into Gmail

How to Import Messages into Gmail

This article will explain how to import email from your %%BRAND%% email accounts to a Google Workspace (formerly G Suite) account.

Detailed instructions can also be found on Google's support site.

1. Log in to your Google Dashboard.
2. Click on the Data Migrations Icon. 
3. Click Set Data Migration up.
4. Configure your source connection settings.
    

   Source Connection Settings
   Migration Source	Select the type of source server you are migrating from. If you don't know or are unsure, select I don't know then, select the type of items to migrate from your source server.
   Connection Protocol	Select the protocol to use to talk to your source server. We recommend that you choose 'Auto Select (Recommended).'
   Role Account	Enter the email address and password of a role account. This is an account on your source server. The account is used to verify that your source server may be connected to, and migration reports may be sent to the account. Then click the start button.

   Additional Migration Settings
   Migration Deleted Email	Select the start date for your migration. Your email will be migrated from that date to the most recent, starting with the most recent first.
   Migrate Junk Email	Choose migration options, then click select users.

   
5. You can select a specific user or upload a CSV (for multi-user purposes).
   
   

   For multi-user, follow the steps below to use a CSV mapping file:

   If you're migrating emails for multiple users, using a CSV file can help streamline the process.

   This method allows you to bulk map source and target accounts using a spreadsheet. The new data migration service uses this mapping to transfer messages between accounts.

   1. Create a CSV mapping file
      1. Download a sample file for reference by clicking Download sample CSV file.
      2. In a spreadsheet program (e.g., Google Sheets, Excel), create a new file with the following headers:
         • Source ImapUser – the user's email address on the source account
         • Source ImapPassword – the password for the source account (or app password, if required by the server)
         • Target GUser – the user’s email address on the target Google Workspace account
         TIP: Check your IMAP provider’s documentation to confirm whether an app password is needed.

         Here’s an example of what your file might look like:

         Source ImapUser	Source ImapPassword	Target GUser
         user1@example.com	password1	user1@yourdomain.com
         user2@example.com	password1	user2@yourdomain.com

      3. Save the file in CSV format.
      Guidelines:

      • Each source user must map to only one target user.
      • The file must include no more than 100 users.
      • File size must be 128 MB or less.
      • Ensure all email addresses are valid.
   2. Upload your CSV file
      1. Go to the Data Migration section in your Admin console.
      2. Click Upload CSV.
      3. Select your file and click Open.
      4. Check the status under Tasks to confirm the upload was successful.
   3. Delete a CSV file (Optional)

      If your upload fails or you need to make corrections:

      1. Locate the uploaded file.
      2. Click the Delete icon.
      3. Confirm by clicking Yes.
      4. Return to Step b to upload a new version.
6. Click Start to start the migration, and you will get an Initializing status.
   
7. This Data migration dashboard will show you the status of your email during migration. 
   
   Note:
   Once you see the Initializing status, it may take some time depending on how much content is being migrated to complete, with no extra action needed.