Migrate data from PST files

G Suite Migration for Microsoft Exchange

You can use G Suite Migration for Microsoft Exchange (GSMME) to migrate email, calendar, or contact data to G Suite accounts from PST files through the GSMME interface or the command line. You can also apply your organization's Google Vault retention rules and holds to emails migrated from PST files without adding the messages to users' Gmail inboxes.

Notes for PST files and Vault

If you decide to make emails migrated from PST files (using GSMME's "Migrate to G Suite Vault" setting) subject to Vault, keep in mind:

  • Migrated messages don't appear in users’ Gmail inboxes.
  • Folder information is removed from messages before they’re migrated, so they won’t have labels in Vault.
  • GSMME doesn't overwrite or check for duplicate messages previously migrated to Vault.
  • Target users must have the Gmail service turned on.
  • Migration to Vault Former Employee (VFE) licensed users will be unsuccessful (because Gmail isn't turned on for these users).
  • For more information on Vault, go to the Google Vault Help Center.

Before you begin

  1. Make sure your GSMME client machine is using a supported version of Microsoft Outlook. Learn more
  2. Create a control CSV file for user accounts. Learn more

    If you're migrating calendar resources, you should also create a mapping CSV file. Learn more

  3. Next, authorize GSMME for your account.
  4. Turn off password protection, and allow read and write permissions on each PST file.
  5. Prepare the PST folder structure:
    1. Set up a top-level folder.
    2. Within that top-level folder, create an individual folder for each user whose PST files you want to migrate.
    3. Name the individual folders the same as the primary email addresses in the legacy environment. For example, if your source environment email addresses are user1@domain.com and user2@domain.com, then name your individual folders user1@domain.com and user2@domain.com.
    4. Place the PST files within the individual folders.


      C:\PST (top-level folder)
      user1@domain.com (user folder)
      Mail.pst (PST file)
      Archive.pst (PST file)
      user2@domain.com (user folder)
      Archive.pst (PST file)

Note: When you migrate mail folders, the email is labeled with the PST filename. To avoid this, migrate using the command line and specify the --noenable_label_prefix command.

Migrate your data

Use the GSMME interface or the command line to migrate data from PST files.

Use the GSMME interface to migrate

Step 1: Exchange server details

  1. Run GSMME: Click Start and then G Suite Migration and then G Suite Migration for Microsoft Exchange.
  2. For Server Type, select Exchange.
  3. Select the Specify a folder with PST files option.
  4. In the Folder with PST files field, specify the path to the top-level PST folder (example above).
  5. Click Next.

Step 2: User and domain information

  1. In the G Suite domain name field, specify the new primary G Suite domain where the data will be migrated.
  2. In the Service account credentials file field, specify the path to the JSON credentials file created as part of the authorization process.
  3. In the G Suite admin user field, specify the full email address of your G Suite domain super administrator.
  4. Click Next to specify the migration settings.

Step 3: Migration settings

(Option 1) To migrate directly to G Suite, follow these steps:

  1. Select the checkbox for each type of data you want to migrate: email, calendar, or contacts.
  2. In the File of accounts to migrate field, specify the path to the CSV file of user accounts you're migrating.
  3. Click Next.

(Option 2) To make messages subject to Vault, but not available in users' Gmail inboxes, follow these steps:

  1. Check the Email messages box as the type of data you want to migrate.
  2. Click Advanced Options.
  3. Check the Migrate to G Suite Vault box and click OK.
  4. Click Next.

Step 4: Review migration settings

  1. Review the migration settings and optionally make changes.
  2. Select your migration actions:
    • Migrate all data—When checked, the utility overwrites existing data during migration. When unchecked, duplicate messages are skipped.
    • Save settings—When checked, the utility retains the current configuration for future use.
    • Run Diagnostics—When checked, the utility verifies the configuration before running the migration.
    • Estimate—When checked, the utility estimates the message count for the source users.
    • Migrate—When checked, the utility performs the migration.
  3. Click Next.
  4. In the dialog that appears, specify the username and password for the Exchange administrator account you're using to open your users' mail stores.

    Tip: Selecting Remember my password bypasses this step in future migrations.

  5. Click Start to begin the migration process.
Use the command line to migrate

Specify the following command to migrate using the command line. Learn more

ExchangeMigration.exe --nouse_gui --run_diagnostics
--pst_base_folder=<PST top-level folder name>
--filename=<filename containing user list>
--service_account_json_path=<absolute path to JSON file>

If you want to make messages subject to Vault, but not available in users' Gmail inboxes, add the --migrate_to_vault argument with no parameter.

To avoid entering the source profile in your destination account, add the --no_enable_label_prefix argument with no parameter.

Note: This example command is a continual single line. Any line breaks visible here are for readability only.


Messages missing or not migrated with the correct sender or recipient

A PST file might not contain the SMTP address for a message's sender or recipient. Instead, it can have the Exchange X.500 address. This issue can occur if no Global Address List (GAL) profile is created or the user has been removed from the GAL. To resolve the issue, go to Troubleshoot GSMME.

All calendars migrated as additional calendars

If you’re using an exported or archived PST file, it’s not possible to identify the primary root folder for Calendar and Contacts. All calendars are migrated as “additional calendars” into Google Calendar, instead of as a default calendar.

You can avoid this by only migrating email from PST files and using Exchange to migrate calendar and contact data.

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue