Rename user addresses in bulk after changing your primary domain

Here's how to change the email addresses for a large number of users, after changing the primary domain for your Google Workspace account. For example, if your organization’s primary domain was example.com and you change it to solarmora.com, you'll need to change everyone's address from user@example.com to user@solarmora.com.

Tip: Expect this process to take anywhere from 6 minutes for 240 users to 10 hours for 24,000 users.

Change email addresses using a spreadsheet

Before you begin: Consider the Impact of changing a username.

Step 1: Export a list of users to Sheets
  1. Sign in to your Google Admin console.

    Sign in using an account with super administrator privileges (does not end in @gmail.com).

  2. From the Admin console Home page, go to Users.
  3. At the top of the page, click Bulk update users.

  4. Click Download user info in CSV file to download a comma-separated values (.csv) file with all user accounts.

    Your Tasks list opens automatically and shows the progress of the download.

Step 2: Add user email addresses

After processing:

  1. Under Your Tasks, click Download CSV.
  2. (Optional) Remove users from the spreadsheet that you don’t want to rename, including the username that you used to sign in.
  3. Copy the full list of user email addresses from the Email Address column and paste it into the New Primary Email column.
  4. Select the New Primary Email column.
  5. Click Editand thenFind and Replace.
  6. In Find, enter the old primary domain.
  7. In Replace with, enter the new primary domain.
  8. Click Replace all.
  9. Save the spreadsheet as a CSV file.
Step 3: Upload the spreadsheet
  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Users.
  3. At the top of the Users page, click Bulk update users.
  4. Click Attach CSV file.
  5. Browse to the location on your computer and attach the CSV file.
  6. Click Upload.
  7. If there's an error, enter the missing information in your spreadsheet and upload the file again. For more information, go to common errors.

    Your Tasks list opens automatically and shows the progress of the upload. Once processing is complete, you'll receive an email report.

  8. If there's a processing error, download the log file from your Tasks list. 

For more, read Resolve common errors.

It can take up to 24 hours for new users to access Google Workspace services and appear in the Google Workspace Directory.

Related topics

Was this helpful?
How can we improve it?