Editing registration settings for a domain

This page describes how to edit registration settings, including contact settings, privacy settings, and DNS settings for an existing domain in Cloud Domains.

Editing contact and privacy settings

When you register a domain, you must submit contact information for that domain. There are three types of contact information:

  • Registrant: Owner of the domain
  • Admin: Person responsible for administrative decisions about your domain
  • Technical: Person responsible for technical changes to your domain

You can choose to enter the same information for all three types of contacts for a domain or choose to enter different contact details for each type of contact. You can also edit existing contact settings.

Cloud Domains also enables you to choose the privacy settings for your contact information based on the available options for the domain ending that you choose. The following table shows the various privacy options that might be available:

Privacy option Description
Privacy protection on

Choosing this option ensures that your contact information is not available to the public. To help protect your contact information and prevent spam, a third party provides alternate (proxy) contact information for your domain in the public directory. The third-party provider forwards all messages that are sent to your proxy contact information to the actual private contact information.

Cloud Domains does not offer privacy protection for all domain endings or top-level domains (TLDs). Registries, the organizations that manage domain endings, have policies prohibiting the use of privacy protection for certain TLDs. To see privacy information for a specific TLD, click the TLD on the Supported TLD reference page. Privacy information for the TLD is available in the DNS reference section.

Limit your info available to the public Choosing this option makes limited personal contact information available to the public. The actual information available publicly depends on the domain that you have chosen. To see privacy information for a specific TLD, click the TLD on the Supported TLD reference page. Privacy information for the TLD is available in the DNS reference section.
Make all contact info public Choosing this option makes all your contact information available to the public through the WHOIS database.

To edit a registration's contact settings, like email, phone number, and postal address, and to choose privacy settings for the contact information, follow these steps:

Console

  1. Go to the Cloud Console.

    Go to the Cloud Domains page

  2. Click the domain name that you'd like to edit. You can also click next to the domain name to see the edit menu.
  3. To edit contact details including the name, address, and email associated with the domain, click Edit contact details.
  4. Make the required changes.
  5. Choose or edit the privacy settings. The privacy options available for the domain you have selected might vary.
  6. Click Save.

gcloud

Use the gcloud beta domains registrations configure contacts command:

gcloud beta domains registrations configure contacts DOMAIN_NAME

Replace DOMAIN_NAME with the name of the registered domain—for example, example.app.

The following example shows the output when you change the privacy settings for a domain example.com:

Contact data not provided using the --contact-data-from-file flag.

Do you want to enter it interactively (y/N)?  y

Which contact do you want to change?
 [1] all the contacts to the same value
 [2] registrant contact
 [3] admin contact
 [4] technical contact
 [5] cancel
Please enter your numeric choice (1):  1

Full name:  NAME
Organization (if applicable):  ORGANIZATION
Email (darcy@gmail.com):  EMAIL_ADDRESS
Enter phone number with country code, e.g. "+1.8005550123".
Phone number:  PHONE_NUMBER
Enter fax number with country code, e.g. "+1.8005550123".
Fax number (if applicable):  FAX_NUMBER
Enter two-letter country code, e.g. "US" or "PL".
Refer to the guidelines for entering address field information at https://support.google.com/business/answer/6397478.
Country / Region code:  COUNTRY_CODE
Postal / ZIP code:  ZIP_CODE
State / Administrative area (if applicable):  STATE
City / Locality:  CITY
Address Line 1:  ADDRESS_LINE_1
Address Line 2 (if applicable):  ADDRESS_LINE_2
Address Line 3 (if applicable):
Your current contact privacy is REDACTED_CONTACT_DATA.

Do you want to change it (y/N)?  y

Specify contact privacy
 [1] private-contact-data
 [2] redacted-contact-data
 [3] public-contact-data
Please enter your numeric choice (2):  1

Waiting for 'operation-1596738116518-5ac39903c0348-5391fe45-78f57284' to
complete...done.
Updated registration [example.com] Note:
The contact settings are currently pending.
In order to finalize the update you need to confirm the change.
An email with instructions has been sent to the registrant.

Replace the following:

  • NAME: your full name—for example, Alice Smith.
  • ORGANIZATION: (optional) your organization—for example, Doe Corp.
  • EMAIL_ADDRESS: your email address for verification—for example alice@example.net.
  • PHONE_NUMBER: the phone number of the contact in international format—for example, +1-800-555-0123.
  • FAX_NUMBER: the fax number of the contact in international format—for example, +1-800-555-0123.
  • COUNTRY_CODE: the country or region code of the address—for example, US for United States.
  • ZIP_CODE: the postal code or ZIP code of the address—for example, 94043.
  • STATE: the state or administrative area of the address—for example, CA.
  • CITY: the city or locality of the address—for example, Mountain View.
  • ADDRESS_LINE_1: the first address line of the registrant—for example, 1599 Bayview Parkway. You can have up to 5 address lines but only the first one is required.
  • ADDRESS_LINE_2: (optional) the second address line of the registrant—for example, APT. 123.

API

Use the configureContactSettings method:

POST https://domains.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureContactSettings

Replace the following:

  • PROJECT_ID: the name of your project
  • DOMAIN_NAME: the domain for which you want to change contact settings

With a request body like the following:

  • To change the registrant contact's email address:

    {
      "contactSettings": {
        "registrantContact": {
          "email": "new-registrant@example.com",
        },
      },
      "updateMask": "registrantContact.email",
    }
    
  • To change the privacy setting to public:

    {
      "contactSettings": {
        "privacy": "PUBLIC_CONTACT_DATA",
      },
      "updateMask": "privacy",
      "contactNotices": ["PUBLIC_CONTACT_DATA_ACKNOWLEDGEMENT"],
    }
    
  • To change the entire registrant contact and the privacy setting:

    {
      "contactSettings": {
        "privacy": "CONTACT_PRIVACY",
        "registrantContact": {
          "postalAddress": {
            "regionCode": "REGION_CODE",
            "postalCode": "POSTAL_CODE",
            "administrativeArea": "SUBDIVISION",
            "locality": "CITY",
            "addressLines": [
              "ADDRESS"
            ],
            "recipients": [
              "CONTACT_NAME"
            ],
            "organization": "ORGANIZATION"
          },
          "email": "EMAIL_ADDRESS",
          "phoneNumber": "PHONE_NUMBER",
          "faxNumber": "FAX_NUMBER"
        }
      },
      "updateMask": "privacy,registrantContact",
    }
    

    Replace the following values for the registrantContact, adminContact or the technicalContact that you want to change:

    For detailed information on each type of contact, see Contact privacy.

    • CONTACT_PRIVACY: the preferred privacy setting for the contact data
    • REGION_CODE: the region code of the address—for example, US for United States
    • POSTAL_CODE: the postal code of the address—for example, 94043
    • SUBDIVISION: the highest administrative subdivision of an address, like a state, a province, an oblast, or a prefecture. For example, CA for the state of California
    • CITY: the name of the city or town of the address. For example, Mountain View
    • ADDRESS: the lower levels of an address—for example, 1599 Amphitheater Parkway
    • CONTACT_NAME: the name of the contact
    • ORGANIZATION: (optional) the name of the organization that is registering the domain—for example, Doe Corporation
    • EMAIL_ADDRESS: the email address of the contact—for example, john@example.com
    • PHONE_NUMBER: the phone number of the contact in international format—for example, +1-800-555-0123
    • FAX_NUMBER: (optional) the fax number of the contact in international format—for example, +1-800-555-0123.

Editing DNS settings

To edit or configure the DNS settings of a registration, including authoritative name servers for the domain, follow these steps:

Console

  1. Go to the Cloud Console.

    Go to the Cloud Domains page

  2. Click the domain name that you'd like to edit. You can also click the icon next to the domain name to see the edit menu.
  3. To edit the DNS details including the DNS provider option and the DNSSEC settings, click Edit DNS details. You can choose one of the following available options:
    DNS provider Description Cost
    Cloud DNS Google recommends that you use Cloud DNS as your provider for all your name servers. Using Cloud DNS requires that you create a public DNS zone for one or more domains that you want to register. To create a public DNS zone, see Creating a public zone. Additional Cloud DNS charges apply. For details, see the Cloud DNS pricing page.
    Google Domains If you choose this option, you can configure your name servers through Cloud Domains, and then use Google Domains to configure the DNS resource records. Note that using Google Domains does not allow API access. No additional cost.
    Custom name servers Choosing the custom name server option enables you to set up your name servers using Cloud Domains, then configure your DNS resource records with a third-party DNS provider. Check with your DNS provider.
  4. Click Save.

gcloud

Use the gcloud beta domains registrations configure dns command:

gcloud beta domains registrations configure dns DOMAIN_NAME

Replace the following:

  • DOMAIN_NAME: The name of the registered domain—for example, example.app.

The following example shows the output when you change the DNS provider from Google Domains to Cloud DNS for the domain example.com:

Your current DNS settings are:
googleDomainsDns:
 dsState: DS_RECORDS_UNPUBLISHED
 nameServers:
 - ns-cloud-b1.googledomains.com
 - ns-cloud-b2.googledomains.com
 - ns-cloud-b3.googledomains.com
 - ns-cloud-b4.googledomains.com
You can provide your DNS settings by specifying name servers, Cloud
DNS Managed Zone name or by choosing free name servers provided by
Google Domains
 [1] Provide name servers list
 [2] Provide Cloud DNS Managed Zone name
 [3] Use free name servers provided by Google Domains
 [4] cancel
Please enter your numeric choice (4):  2

Cloud DNS Managed Zone name:  example-app

Waiting for 'operation-1596738623568-5ac39ae74fa6f-1025c18d-9d3a4872' to
complete...done.
Updated registration [example.com].

API

Use the configureDnsSettings method:

POST https://domains.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureDnsSettings
Replace the following:

  • PROJECT_ID: the name of your project
  • DOMAIN_NAME: the domain you want to change contact settings for

The request body can be one of the following:

  • To update or switch to custom name servers:

    {
      "dnsSettings": {
        "customDns": {
          "nameServers": [
            "ns-cloud-a1.googledomains.com",
            "ns-cloud-a2.googledomains.com",
            "ns-cloud-a3.googledomains.com",
            "ns-cloud-a4.googledomains.com"
          ]
        }
      },
      "updateMask": "customDns"
    }
    

  • To update or switch to Google Domains name servers:

    {
      "dnsSettings": {
        "googleDomainsDns": {
          "dsState": "DS_RECORDS_UNPUBLISHED"
        }
      },
      "updateMask": "googleDomainsDns"
    }
    

What's next