Before you change your primary domain
Changing your primary domain isn't always necessary. Depending on how you want to use the domain, you might be able to simply add it as a domain or domain alias. If you do decide to change your primary domain, there are some issues you need to consider first.
If after considering all the issues listed below and you still want to change your primary domain, go to Change your primary domain from the Admin console.
Note: Changing your primary domain from the Admin console is currently not supported for:
- A reseller's own primary domain
- Customers with a domain registered with Google Domains
- Device subscriptions (including Chrome device management, Chromebox for meetings and Google Play for Education)
- G Suite customers in a trial period.
- G Suite Standard edition—also known as the Free or legacy edition.
When do I need to change my primary domain?
Changing your primary domain is generally only necessary if you:
- Would like your users to login to their accounts using a new primary domain name.
- Lose ownership of your old domain and would like to remove it from your account.
- Use Google App Engine, which authenticates via user accounts on the primary domain.
- Would like consistent branding in Drive shares and Calendar invites, which always shows the primary email address of the user.
Known issues when changing your primary domain
Google Play for Education
- Updating your primary domain may cause issues for Google Play for Education. Policies may be disrupted and devices may have complications completing enrollment and re-enrollment. Additionally, annual subscription services could encounter ordering issues when purchasing additional licenses and attempting to complete renewals.
- Calendar events created before a primary domain rename may not change or update domain rooms and resources following the rename.
- After you rename the primary domain, if you delete the old domain from the list of secondary domains any secondary calendars created before the rename will be deleted automatically.
- You may need to update your business contact information in the billing profile to ensure that all important billing notifications are sent to the correct contact.
- Reapply any custom logos after the primary domain has been renamed.
- To view their sites, users have to replace the old domain name with the new domain name in the URL (for example, sites.google.com/a/<old_domain> needs to be changed to sites.google.com/a/<new_domain>).
- Any sites that still exist on the old domain are accessible using the old URL.
- If you delete the old domain, any existing sites on the old domain are also deleted. If you want to retain those sites, you need to copy them using the Google Sites API prior to changing your primary domain.
Marketplace and Google App Engine apps
- Any apps that you have added via Marketplace or Google App Engine will need to be reinstalled. If the app saves data based on the domain name or a user's email address, the data may be lost. Check with the App developer first, if you are not sure.
- After renaming a domain, domain aliases remain linked to the previous primary domain. This will, in turn, affect the creation of email aliases after users are renamed.
General considerations when changing your primary domain
- When you change the domain name, it may take some time for the changes to be seen in your Apps.
- Changing the name of your domain doesn't automatically change the primary email address of the users and groups that were provisioned under that domain. You can rename your users to your new primary domain, but first make sure that you understand the impact of changing a username before you proceed. You can also change a group's email address.
- In order to start receiving mail on the new email addresses, MX records must be set up pointing to G Suite. We strongly recommend that you do this prior to performing the rename.