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.
First, make sure changing your primary domain is supported for your type of managed Google account. Then, after considering all the issues listed below, you still want to change your primary domain, go to Change your primary domain from the Admin console.
Make sure your managed Google account is supported
Changing your primary domain from the Admin console is currently not supported for:
- A reseller's or reseller applicant's own primary domain (a reseller's customers can change their domain names)
- Customers who purchased a domain name through a Google domain registrar partner or Google Domains when signing up for their Google service
- Customers who purchased their Google service through 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
Consider these issues before changing your primary domain
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.
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.
- 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.
With regard to the publish URL, if the old domain is deleted, existing sites on the old domain are unpublished. Site owners will be notified by email with instructions to republish their sites updating the publish URL.
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.
- All video call links in existing (including recurring) events include the old domain name. This means users cannot attend by clicking the link. This also applies to email reminders and change notification emails. Events created after the change include the correct domain in the video call link.
- The calendar email address does not get updated for events created before the domain rename. This means that users cannot check the resource calendar for this event. Events created after the change appear with the correct domain in the resource calendar address.
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.
- If you have an associated Google Cloud Platform (GCP) account, your GCP organization resource display name is updated to match your new domain name. It can take several days for the change to take effect.
- 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 Google. We strongly recommend that you do this prior to performing the rename.