Migrate from Google Workspace (Bulk)

This guide walks you through migrating multiple Google Workspace (or personal Gmail) accounts to TrekMail at once using Bulk Import.

Before you start

Each Google account needs its own App Password for IMAP access. Regular passwords will not work.

Generate App Passwords (per user)

1. Go to myaccount.google.com and sign in.
2. Navigate to Security > 2-Step Verification (enable it if not already on).
3. Search for App passwords in the account settings.
4. Create an App Password for Mail on Other (Custom name), named something like TrekMail Import.
5. Copy the 16-character code. This is the source_password for that user.

Repeat for each account you want to migrate.

Enable IMAP (if disabled)

In Gmail: Settings > Forwarding and POP/IMAP > select Enable IMAP > Save Changes.

Prepare your CSV

Since all accounts are on Gmail, use the simple 3-column format:

source_email,source_password,destination_email
alice@yourcompany.com,abcd-efgh-ijkl-mnop,alice@yourdomain.com
bob@yourcompany.com,qrst-uvwx-yz12-3456,bob@yourdomain.com
carol@yourcompany.com,7890-abcd-efgh-ijkl,carol@yourdomain.com

Tip: Ask each team member to generate their App Password and share it with the admin securely.

Run the bulk import

1. Go to Import > Bulk Import tab.
2. Select Gmail as the provider.
3. Paste your CSV or upload the file.
4. Set options (All folders recommended for full migration).
5. Click Preview & Validate — check that all rows are in "Ready".
6. Click Start Migration.

What to expect

• Gmail's [Gmail]/Sent Mail, [Gmail]/All Mail, and other Gmail-specific folders are automatically mapped to standard folder names (Sent, Archive, etc.).
• Large mailboxes (10,000+ messages) may take 30-60 minutes per account.
• Gmail may rate-limit IMAP connections. TrekMail automatically throttles to avoid blocks (max 5 concurrent per source host).

Common issues

• "Authentication failed" — You used the regular password instead of the App Password, or 2-Step Verification is not enabled.
• "Connection refused" — IMAP is not enabled in Gmail settings.
• Rate limiting — If many accounts are on the same Google Workspace domain, some may queue longer. This is normal.