Rename users in large organizations

As a G Suite administrator, if an organization’s domain is example.com and changes to solarmora.com, change the usernames from username@example.com to username@solarmora.com.

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

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 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 list, click Download Download.
  4. Select the following options:
    • All user info columns and currently selected columns
    • Google Sheets
  5. Click Download.

    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 Open in Google Sheets.
  2. (Optional) Remove users from the spreadsheet that you don’t want to rename, including the username that you used to sign in.
  3. In the spreadsheet, remove all of the columns except Name and Email Address.
  4. Add a new column titled New Primary Email.
  5. Copy the full list of user email addresses from the Email Address column and paste it into the new column.
  6. Select the New Primary Email column.
  7. Click Editand thenFind and Replace.
  8. In Find, enter the old primary domain.
  9. In Replace with, enter the new primary domain.
  10. Click Replace all.
  11. 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. On the Users page, point to Add new user and click Upload Upload.
  4. Browse to the location on your computer and attach the CSV file.
  5. Click Upload.

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

  6. If there's an error, enter the missing information in your spreadsheet and upload the file again.

For more, read Resolve common errors.

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

Related topics

Was this helpful?
How can we improve it?