This page describes how to migrate your Google Domains DNS settings and export your domain and email forwarding configurations if you use Google Domains as your DNS provider.
If you don't use Google Domains as your DNS provider, you don't need to take any action.
If you don't use domain forwarding or email forwarding but use Google Domains as your DNS provider, you can Migrate your Google Domains DNS settings to Cloud DNS.
If you use domain or email forwarding, you can Export domain and email forwarding configurations.
Before you begin
Check to see if you use Google Domains as your DNS provider, and if you have domain or email forwarding set up.
Console
In the Google Cloud console, go to the Cloud Domains page.
The Registrations page lists your registrations.
Click the domain name for which you want to get the information.
You can check if a specific domain uses Google Domains as its DNS provider or if the domain has domain or email forwarding configurations.
gcloud
To view registration details for a specific domain, use the
gcloud domains registrations describe
command:
gcloud domains registrations describe DOMAIN_NAME
Replace DOMAIN_NAME
with the name of the domain that
you want to view details for—for example, example.app
.
If your domain uses Google Domains as your DNS provider, the
dnsSettings
section of the output looks similar to the following example:
dnsSettings: googleDomainsDns:
If your domain uses domain or email forwarding configurations, the
dnsSettings
section of the output looks similar to the following example:
dnsSettings: ... googleDomainsRedirectsDataAvailable: true
Migrate your Google Domains DNS settings to Cloud DNS
To migrate your Google Domains DNS settings, follow these steps.
gcloud
Create a managed public zone for your domain.
Use the
dns managed-zones create
command:gcloud dns managed-zones create ZONE_NAME \ --description=DESCRIPTION \ --dns-name=DOMAIN_NAME \ --visibility=public \ [--labels=LABELS] \ [--dnssec-state=DNSSEC_STATE]
Replace the following:
ZONE_NAME
: a name for your zoneDESCRIPTION
: a description for your zoneDOMAIN_NAME
: the domain name for your zone—for example,example.com
. To use a DNS zone for a domain name, you must ensure that the DNS suffix in the zone matches the domain name. Note thatexample.com
andexample.com.
are considered equivalent.LABELS
: a comma-delimited list of key-value pairs such asdept=marketing
orproject=project1
. This flag is optional. For more information, see the SDK documentationDNSSEC_STATE
: the DNSSEC state for your zone. For more information, see DNS Security Extensions (DNSSEC) overview. This flag is optional.
Disable DNSSEC for your domain.
If DNSSEC is enabled, disable it and wait 24 hours for the change to take effect.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME \ --disable-dnssec
Replace
DOMAIN_NAME
with the name of the domain for which you want to disable DNSSECRetrieve the DNS record information from your Google Domains DNS zone.
Use the
gcloud domains registrations google-domains-dns export-dns-record-sets
command:gcloud domains registrations google-domains-dns export-dns-record-sets DOMAIN_NAME \ --records-file=RECORDS_FILE \ --zone-file-format
Replace the following:
DOMAIN_NAME
: the name of the domain for which you want to retrieve the DNS record informationRECORDS_FILE
: the file to which the record sets must be exported—for example,records.zonefile
Import the records to the Cloud DNS zone.
Use the
dns record-sets import
command. The--zone-file-format
flag sets theimport
command to expect a BIND zone file. If you omit this flag,import
expects a YAML file:gcloud dns record-sets import RECORDS_FILE \ --zone=ZONE_NAME \ --zone-file-format \ --delete-all-existing
Replace the following:
RECORDS_FILE
: the file from which the record sets must be imported—for example,records.zonefile
ZONE_NAME
: the name of the managed zone whose record sets you want to manage
Start using the migrated Cloud DNS zone.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME \ --cloud-dns-zone=ZONE_NAME
Replace the following:
DOMAIN_NAME
: the name of the registered domain—for example,example.app
.ZONE_NAME
: the name of the managed zone whose record sets you want to manage
Monitor your domain. If you encounter any DNS configuration issues, roll back the migration.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME --use-google-domains-dns
Replace
DOMAIN_NAME
with the name of the registered domain—for example,example.app
.Optional: Enable DNSSEC for your domain.
- Wait for at least 24 hours after completing step 5.
- Use the
gcloud domains registrations configure dns
command:
gcloud domains registrations configure dns DOMAIN_NAME \ --cloud-dns-zone=ZONE_NAME \ --no-disable-dnssec
Replace the following:
DOMAIN_NAME
: the name of the registered domain—for example,example.app
.ZONE_NAME
: the managed zone name for which you want to disable DNSSEC
Export your domain and email forwarding configurations to another hosting provider
gcloud
Disable DNSSEC for your domain.
If DNSSEC is enabled, you must disable it and wait 24 hours for the change to take effect.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME \ --disable-dnssec
Replace the following:
DOMAIN_NAME
: the name of the domain for which you want to disable DNSSEC
Export your Google Domains DNS configuration.
Use the
gcloud domains registrations google-domains-dns export-dns-record-sets
command:gcloud domains registrations google-domains-dns export-dns-record-sets DOMAIN_NAME \ --records-file=RECORDS_FILE \ --zone-file-format
Replace the following:
DOMAIN_NAME
: the name of the domain for which you want to retrieve the DNS record informationRECORDS_FILE
: the file to which the record sets must be exported—for example,records.zonefile
Retrieve your Google Domains domain and email forwarding configuration.
Use the
gcloud domains registrations google-domains-dns get-forwarding-config
command:gcloud domains registrations google-domains-dns get-forwarding-config DOMAIN_NAME
Replace
DOMAIN_NAME
with the name of the registered domain—for example,example.app
.Import the DNS records and forwarding configuration to your new hosting provider. For instructions, contact your hosting provider.
Configure domain and forwarding settings for your new hosting provider. For instructions, contact your hosting provider.
If you have
MX
andCNAME
records, make sure that you configure these records to redirect services to your new hosting provider.Update the name server for your domain. You can get the name server information from your new hosting provider.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME \ --name-servers=NAME_SERVERS_LIST
Replace
NAME_SERVERS_LIST
with a list of DNS name servers for the domain.Monitor your domain. If you encounter any DNS configuration issues, roll back the migration.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME --use-google-domains-dns
Optional: Enable DNSSEC for your DNS zone at your hosting provider.
- Wait for 24 hours after you enable DNSSEC for your DNS zone.
Enable DNSSEC for your domain.
Use the
gcloud domains registrations configure dns
command:gcloud domains registrations configure dns DOMAIN_NAME \ --dns-settings-from-file=DNS_SETTINGS_FILE_NAME
Replace the following:
DOMAIN_NAME
: the name of the registered domain—for example,example.app
.DNS_SETTINGS_FILE_NAME
: the YAML file containing the required DNS settings. If specified, its content replaces the values used in the registration resource. If the YAML file is missing some of thedns_settings
fields, those fields are removed.Example of the file contents:
customDns: nameServers: - new.ns1.com - new.ns2.com dsRecords: - keyTag: 24 algorithm: RSASHA256 digestType: SHA256 digest: ab1cfa82b035c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
What's next
- To find answers to frequently asked questions, see Squarespace purchase of Google Domains FAQ.
- To find solutions for common issues that you might encounter when using Cloud Domains, see Troubleshoot Cloud Domains.