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 changing your domain.

Know the restrictions

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

Contact support for assistance with these services: 

  • Support for Google Meet hardware 
  • Support for Google Workspace for Nonprofits 
  • Support for a standalone offline Chrome Enterprise Upgrade, a standalone Chrome Education Upgrade and for a Chrome Enterprise trial

Change your primary domain

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

You can 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. If SSO is configured using a domain-specific issuer and a third-party identity provider, the SAML assertion modifies to reflect the new primary domain. To guarantee that users can authenticate following the primary domain swap, check the setup of your identity provider. For details, go to SSO assertion requirements.
  5. 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. In the Admin console, go to Menu ""and then"" Accountand thenDomainsand 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. 
      • 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. In the Admin console, go to Menu ""and then"" Accountand thenDomainsand 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 Restrictions 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. In the Admin console, go to Menu ""and then"" Directoryand thenUsers.
  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. In the Admin console, go to Menu ""and then"" Directoryand thenGroups.
  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
false
false
true
true
73010
false
false
false
true
false
false