This page describes how to edit registration settings—including contact settings, privacy settings, and DNS settings—for an existing domain in Cloud Domains.
Before you begin
Before you complete the tasks, review the following information on the Cloud Domains overview and Troubleshooting pages:
- Contact information
- Privacy protection
- Contact details while registering or transferring a domain for a company
Edit contact and privacy settings
When you register a domain, you must submit contact information for that domain.
To edit a registration's contact settings, such as email, phone number, and postal address, and to choose privacy settings for the contact information, complete the following steps.
Console
In the Google Cloud console, go to the Cloud Domains page.
Click the domain name that you want to edit. You can also click
More next to the domain name to see the edit menu.To edit contact details, including the name, address, and email associated with the domain, click Edit contact details.
Make the required changes.
Choose or edit the privacy settings. The privacy options available for the domain that you selected might vary.
Click Save.
gcloud
Use the gcloud domains registrations configure
contacts
command:
gcloud 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 the 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 StatesZIP_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 registrations.configureContactSettings
method:
POST https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureContactSettings
Replace the following:
PROJECT_ID
: the name of your projectDOMAIN_NAME
: the domain for which you want to change contact settings
The request body can be one of 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 thetechnicalContact
that you want to change. For detailed information about each type of contact, see Contact privacy.CONTACT_PRIVACY
: the preferred privacy setting for the contact dataREGION_CODE
: the region code of the address—for example,US
for United StatesPOSTAL_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 CaliforniaCITY
: 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 contactORGANIZATION
: (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
Edit DNS settings
To edit or configure the DNS settings of a registration, including authoritative name servers for the domain, complete the following steps.
Console
In the Google Cloud console, go to the Cloud Domains page.
Click the domain name that you want to edit. You can also click
More next to the domain name to see the edit menu.To edit the DNS details, including the DNS provider option and the DNSSEC settings, click Edit DNS details. Choose one of the options in the following table.
DNS provider Description Cost Cloud DNS Google recommends that you use Cloud DNS as your DNS provider for all your name servers. Additional Cloud DNS charges apply. For details, see the Cloud DNS pricing page. Custom name servers If you choose this option, you can use Cloud Domains to configure your name servers, and then use a third-party DNS provider to configure your DNS resource records. Check with your DNS provider. Click Save.
gcloud
Use the gcloud domains
registrations configure dns
command:
gcloud domains registrations configure dns 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 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 or Cloud DNS Managed Zone name [1] Provide name servers list [2] Provide Cloud DNS Managed Zone name [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
registrations.configureDnsSettings
method:
POST https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureDnsSettings
Replace the following:
PROJECT_ID
: the name of your projectDOMAIN_NAME
: the domain that 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" }
Turn off automatic renewal for a domain name
All domains renew automatically. To make sure that your domain isn't renewed, turn off automatic renewal at least 15 days before the expiry date.
Console
- In the Google Cloud console, go to the Cloud Domains page. Go to Cloud Domains
- Click the domain name for which you want to turn off automatic renewal.
- Click Disable auto-renewal.
- On the Disable auto-renewal dialog, click Disable.
gcloud
Use the gcloud domains registrations configure management
command:
gcloud domains registrations configure management DOMAIN_NAME \ --preferred-renewal-method=renewal-disabled
Replace DOMAIN_NAME
with the name of the registered
domain—for example, example.app
.
Turn on automatic renewal for a domain name
If automatic renewal is turned off, you must turn on automatic renewal at least one day before the expiry date to renew the domain.
Console
- In the Google Cloud console, go to the Cloud Domains page. Go to Cloud Domains
- Click the domain name for which you want to turn on automatic renewal.
- Click Enable auto-renewal.
- On the Enable auto-renewal dialog, click Enable.
gcloud
Use the gcloud domains registrations configure management
command:
gcloud domains registrations configure management DOMAIN_NAME \ --preferred-renewal-method=automatic-renewal
Replace DOMAIN_NAME
with the name of the registered
domain—for example, example.app
.
What's next
- To view a list of your registered domains, see List registered domains.
- To delete a domain, see Delete a registered domain.
- To access API information, see the Cloud Domains API.
- To find solutions for common issues that you might encounter when using Cloud Domains, see Troubleshooting.