Change your primary domain

 
If you want to change your name for an address that ends in @gmail.com, follow these steps

If your business changes its name, you might want to change your primary domain for G Suite or Cloud Identity. Then you can use your new domain name for your user’s email address, calendar invites, and other notifications (such as invitations to share a Google Docs file).

Changing your primary domain isn't always necessary—and it's an involved process that requires setup. Also, changing domains isn’t available with all editions of G Suite or Cloud Identity.

You might be able to simply add the domain rather than change your primary domain. Learn about alternatives to switching your domain.

Requirements

You can change the primary domain of some G Suite and Cloud Identity editions. Changing the primary domain is not available for: 

Contact G Suite support for your options if you have:

  • G Suite for Education
  • G Suite for Nonprofits
  • Chrome device management
  • Chromebox for meetings
  • Google Play for Education

Switch your primary domain

For a smooth transition, review these steps before changing your primary domain.

Add the new domain to your Admin console and set up email for it. Then, you switch your current primary domain to your new primary domain. You’ll rename each user with their new address so they can get email.

Your old primary domain automatically becomes a domain alias. Your users and groups can get email at their old addresses as well their new addresses. There’s no extra cost for a domain alias. Or, you can remove the old primary domain from your G Suite or Cloud Identity account.

Open all | Close all


Step 1: Prepare for the switch
  • To avoid disruption to a G Suite account you bought from a reseller, before making changes to your domain, notify the reseller.
  • When you remove your old primary domain from G Suite, classic Google Sites on that domain will be deleted. Before you change your primary domain, convert any sites using the new Google Sites.
  • Be sure you can sign in to the domain host (for example, GoDaddy®, Enom®) of your new primary domain. You'll update settings at your domain host to set up email for your new domain. 
  • 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

Important: If your new domain is already an alias, you must remove the domain alias.

Then, follow these steps to add the new domain as another domain. You might need to wait up to 24 hours before the domain can be added. 

  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 Domains.

    If you don't see Domains on the Home page, at the bottom, click More controls.

  3. Click Manage domains and then  Add a domain or a domain alias.
  4. Click Add another domain.
  5. Enter the name of your new primary domain.

    You must own the domain name, and it can't be used with any other Google Account. If the domain is already in use, you’ll get an error message. See troubleshooting tips.

  6. Click Continue to verify domain ownership.

    Follow the verification instructions.

  7. Click Continue and verify domain ownership.
  8. To set up Gmail, update the new domain's MX records.

    This won’t change your email for your current primary domain.

  9. Click I have completed these steps.
  10. To prevent spoofing (spammers sending messages that appear to be from you) and your messages being marked as spam, set up SPF (strongly recommended) and DKIM.
  11. Check that your MX, SPF, and DKIM records are set up for G Suite.
Step 3: Switch to new primary domain
  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 Domains.

    If you don't see Domains on the Home page, at the bottom, click More controls.

  3. Click Manage domains.
  4. Next to your new primary domain, click Make Primary.

    Important: You won’t have the Make Primary option if:

    • You’re trying to use a domain alias. You need to remove that domain and reinsert as an additional domain (see above for step 2).
    • Your type of account doesn’t support switching primary domains. See above for Requirements.

    Add a Domain or a Domain Alias window is shown. Shows the Primary Domain, the secondary domain to make primary, and the domain alias.

  5. Click Change Primary Domain.

    It can take up to 24 hours for the changes to take effect.

Step 4: Rename users and groups with your new domain

Rename Users

You’ll change each user’s email address to use the new domain name. Their old address becomes an email alias. As long as each domain is set up for email with G Suite, users can receive and send email at both addresses.

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

Before you start, review the impact of changing a username.

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

Tip: If you have a large number of users, you can use a spreadsheet to change usernames.

Rename mailing groups

If you have group addresses such as info@old-domain.com, rename them with your new primary domain. The old group address becomes an alias of the new group address. You’ll get email at both group addresses (info@new-domain.com and info@old-domain.com, for example).

  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 Groups.

    If you don't see Groups on the Home page, at the bottom, click More controls.

  3. Click a group you want to rename to open the group's page.
  4. At the top the group's page, click Edit Edit.
  5. Click the Down arrow Down Arrow and select your new primary domain.
  6. Click Save Group Info.
Step 5: Update your G Suite settings

Update settings for:

  • Billing
  • Marketplace and Google App Engine apps
  • Domain aliases
  • Google Calendar
  • Logos and custom URLs
Note: When you change the domain name, it may some time to be seen in your Apps. If you have a Google Cloud Platform (GCP) account, your GCP organization resourcedisplay name may take several days to update.

Steps

  1. To ensure that important billing notifications are sent to the correct email address, check your business contact information.
  2. Check with the app developer to see if you need to reinstall any apps from Marketplace or Google App Engine.

    If the app saves data based on the domain name or a user's email address, the data can be lost.

  3. Reinstall apps from Marketplace or Google App Engine, as needed.
  4. If you had any domain aliases, remove and then reinsert them into your account.

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

  5. In Calendar, remove and then add Hangouts Meet (video meetings or conference rooms).

    The links you created with your old primary domain won’t work.

  6. Recreate secondary calendars.

    Secondary calendars (additional calendars created by a user) continue to display the original primary domain name. See Create a new calendar.

  7. (Optional) To edit sites on the old domain (which are visible using the old URL), have users replace the old domain name with 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.

  8. Update G Suite custom logos and custom URLs.
(Optional) Remove the old primary domain

If you don’t want to use the original primary domain with your G Suite or Cloud Identity account, you can remove the domain.

Before removing 

Make sure there are no existing users or groups using the domain. After you remove the domain, users won't get emails sent to that domain.

After removing

  • All classic sites on the old domain are deleted. Before changing your primary domain, convert your classic site to using the new Google Sites.
  • New sites on the old domain are unpublished. Site owners automatically get an email with instructions on how to publish.
  • Users’ secondary calendars and associated events are also deleted and can't be recovered.
(Optional) Share instructions with your users

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

Example notification

We’ve updated our email from <old-domain.com> to <new-domain.com>. Here is what’s changed and the steps to use your new address:

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

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.

Tip: If you send a message to your old address, it doesn’t appear in your inbox. But, you can find the message in your Sent Mail. Also, read receipts from emails sent by your old email address won’t be forwarded to your new address.

Mailing groups—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. Update information in your Calendar.
    1. Open any existing and recurring events you created.
    2. Remove and then re-create any Hangouts Meet links, conference rooms, or other resources.

      (The old links won’t work.)

  4. If you’re using <any Marketplace or custom apps>, sign out and then sign in with your new address.
Was this helpful?
How can we improve it?