Migrate your Google Domains DNS settings to Cloud DNS or another provider

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.

Go to Cloud Domains

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 zone
- DESCRIPTION: a description for your zone
- DOMAIN_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 that example.com and example.com. are considered equivalent.
- LABELS: a comma-delimited list of key-value pairs such as dept=marketing or project=project1. This flag is optional. For more information, see the SDK documentation
- DNSSEC_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 DNSSEC
Retrieve 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 information
- RECORDS_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 the import 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.
1. Wait for at least 24 hours after completing step 5.
2. 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 information
- RECORDS_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 and CNAME 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.
1. Wait for 24 hours after you enable DNSSEC for your DNS zone.
2. 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 the dns_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.