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
-
In the Google Admin console, go to Menu DirectoryUsers .
Requires having the appropriate User management privilege . Without the correct privilege, you won't see all the controls needed to complete these steps.
- At the top of the page, click Bulk update users
.
- 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:
- Under Your Tasks, click Download CSV .
- (Optional) Remove users from the spreadsheet that you don't want to rename, including the username that you used to sign in.
- Copy the full list of user email addresses from the Email Address column and paste it into the New Primary Email column.
- Select the New Primary Email column.
- Click Edit
Find and Replace .
- In Find , enter the old primary domain.
- In Replace with , enter the new primary domain.
- Click Replace all .
- Save the spreadsheet as a CSV file.
Step 3: Upload the spreadsheet
-
In the Google Admin console, go to Menu DirectoryUsers .
Requires having the appropriate User management privilege . Without the correct privilege, you won't see all the controls needed to complete these steps.
- At the top of the Users page, click Bulk update users .
- Click Attach CSV file .
- Browse to the location on your computer and attach the CSV file.
- Click Upload.
- 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.
-
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.

