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 with a super administrator account to the Google Admin console.

    If you aren’t using a super administrator account, you can’t complete these steps.

  2. Go to Menu  Directory > 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 Addresscolumn and paste it into the New Primary Email column.
  4. Select the New Primary Emailcolumn.
  5. Click Editand then Find 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 with an administrator account to the Google Admin console.

    If you aren’t using an administrator account, you can’t access the Admin console.

  2. Go to Menu  Directory > Users .
  3. At the top of the Userspage, 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?
Search
Clear search
Close search
Google apps
Main menu
5533521171114124099
true
Search Help Center
true
true
true
true
true
73010
false
false
false
false
Design a Mobile Site
View Site in Mobile | Classic
Share by: