Change your primary domain for Google Workspace

This article is for administrators. To change your name for an address that ends in @gmail.com, follow these steps

Add domains to your Google Workspace account

 If you get a new domain or rebrand your company, you might want to change the domain for your Google Workspace account. Then you can use the new domain for your email addresses, Drive sharing, Meet, and other services.

Switching your primary domain is an involved process and you might consider adding another domain to your account instead. Learn about alternatives to switching your domain.

Requirements

Changing the primary domain is not available for these types of Google Workspace or G Suite accounts:

Note: If you have Google Workspace for Nonprofits, Chrome Device Management licenses, or Chromebox for Meetings, or you're an authorized Google Workspace reseller, contact support for recommended steps.

Change your primary domain

Signed up the wrong domain? You can cancel for Google Workspace account during the trial period

You add the new domain to the Google Admin console and set up email. Then, you update the email addresses of your users and groups (for example, info@example.com) to use your new primary domain.

You can keep your old domain as a user alias domain so you get email at both your new and old email addresses. 

Open all | Close all

Step 1: Prepare for the switch
  1. Be sure you can sign in to the domain host (for example, GoDaddy or Enom) of your new primary domain. You need to update domain settings, and your domain host can help you.

  2. If you purchased your account from a reseller, notify your reseller before switching. They can help with the switch.

  3. If you have any classic Google Sites, switch them to the new Google Sites. When you remove your old primary domain, classic Google Sites are deleted.
  4. Notify your users about the switch and the steps they need to take. Below is a sample notification.
Step 2: Add your new domain and set up email
  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 Domainsand thenManage domains.
  3. In Manage domains, click Add a domain.

    The manage domains page is shown with a mouse pointer highlighting the "add a domain" option.

    Note: If you have the legacy free edition of G Suite, the "Add a domain" option isn't available.

  4. Enter the name of the domain you're adding.

    If you recently removed this domain from your Google Workspace account, you need to wait up to 24 hours before adding the domain. Check troubleshooting tips.

  5. Select a domain type:
    • Secondary domain
      • if you plan to replace your primary domain with this new domain. Learn more about changing your primary domain.
      • if you want to add a new domain for a separate team or business unit.
    • User alias domain:
      • if you want to add email aliases (alternate email addresses) for your existing users. Google Workspace will automatically create aliases after you've added the domain.
  6. Click Add and start verification.

    Follow the instructions to verify that you own the domain.

  7. If you want to use Gmail with this domain, return to Manage Domains after your domain is verified. Find the new domain and click Activate Gmail.

    A mouse selector clicks the Activate Gmail button

    Follow the instructions to set up Gmail for your new domain.

Step 3: Switch to new primary domain

Tip: Try the the Home page quick link. On your Admin console Home page, click Change your primary domain.

  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 Domainsand thenManage domains.
  3. Click Change Primary Domain. If you don't have this option:
    • You have a user alias domain. Remove that domain and add it back as a secondary domain (Step 2 above).
    • Your type of account doesn’t support switching primary domains (check Requirements above).
  4. Enter the domain you're making primary and click Change primary domain.

    Important: It can take up to 48 hours for your new primary domain to take effect. Until then, your email will be delivered as usual to your old primary domain. You can continue to the next steps.

Step 4: Switch users and groups to your new domain

Rename users with your new domain

You’ll change each user’s email address to use the new domain name. Before you start, review the impact of changing a username.

Important: When you rename your own admin account, you’ll be automatically signed out. You then sign in with your new username.

  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. Click a user to open their account page.
  4. On the left, click Rename User.
  5. Under Primary email, click the Down arrow "" and select your new primary domain.

    In the user panel, chose the new primary domain for the user.
  6. Click Rename.

Tip: If you have many users, you can use a spreadsheet to change usernames.

Rename mailing groups with your new domain

Update your group addresses to use your new primary domain name. For example, change the address, info@old-domain.com to info@new-domain.com.

  1. Sign in to your Google Admin console.

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

  2. On the Admin console Home page, go to Groups.
  3. Click a group you want to rename to open the group's page.
  4. At the top the group's page, click Edit "".
  5. Click the Down arrow "" and select your new primary domain.
  6. Click Save Group Info.
Step 5: Use or remove the old primary domain

Choose how to use your old domain with Google Workspace:

  • Get email at your old domain and new domain
    Use your old domain as a user alias domain. Then you can send email and receive email at your new primary domain and old domain. No additional cost.
     

User with email address at old and new domain

You'll remove your old domain and then add it as a user alias domain
Learn how

  • Keep your old domain as a secondary domain. This is the default. 
    You can add a separate set of users to the secondary domain. Users have their own email address at the secondary domain, and you pay for each account.
  • Remove the old domain
    If you don’t want to use the original primary domain, remove the domain.
Step 6: Update your Google Workspace settings

Update settings for:

  • Billing
  • User alias domains
  • Marketplace apps
  • Logos and custom URLs
     
  1. Make sure important billing notifications are sent to the correct email address, and check your business contact information.
  2. If you had any user alias domains: remove and then add them back to your account.

    Note: The user alias domains are linked to the old primary domain. After you remove the user alias domain, it can take 24 hours before you can add it back.

  3. If you installed apps from Marketplace: check with the app developer about whether you need to reinstall the app. If an app saves data based on the domain name or a user's email address, some data might be lost.

  4. (Optional) To edit sites on the old domain (which are visible using the old URL), have users enter the new domain name in the URL. For example, instead of sites.google.com/a/old_domain.com, go to sites.google.com/a/new_domain.com.
  5. (Optional) Update custom logos and custom URLs that show up in your users' Google Workspace account.

If you have a Google Cloud account, there's no impact to your projects or resources. The Google Cloud organization resource display name might take several days to update.

(Optional) Share instructions with your users

Let your users know about the change and steps to take. Here’s a sample notification you can customize. For additional steps or tips to include, check the impact of changing a username.

Sample notification - Use your new domain

We changed our email from <old-domain.com> to <new-domain.com>. Here's how to use your new email address:

New name—Your new address will be <yourname@newdomain.com>. You’ll use this address to sign in to your Google Workspace account (your password is unchanged).

Our mailing groups, such as info@ and sales@, have switched to our new name.

Recommended steps

  1. Update your email signature with our new name.
  2. If you’re using <any Marketplace or custom apps>, sign out and then sign in with your new address.

Sample notification - Use your new and old domain email

We changed our email from <old-domain.com> to <new-domain.com>. Here's how to use your new email address:

New name—Your new address will be <yourname@newdomain.com>. You’ll use this address to sign in to your Google Workspace account (no change to your password).

Email—Any mail sent to your old address will arrive in your inbox as usual. Your old address is an alias (additional address) to your new address.

Our mailing groups, such as info@ and sales@ have switched to our new name. But you’ll still get email sent to our old group names.

Recommended steps

  1. Update your email signature with our new name.
  2. Set up Gmail to send messages from your old address.

    In the Email Address field, enter your old email address.

  3. If you’re using any Google Workspace Marketplace or custom apps sign out and then sign in with your new address.


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
73010
false