Domain names

A domain ownership check proves control of the name. A service address then directs users to the application, website or documentation. These checks use different DNS records and should be completed separately.

Before you start — Have access to the DNS management of the domain you control. Identify the service to connect and copy its current records from the project. Ownership verification and the service’s address connection require different records.

Declare and verify a domain

Verify control of the domain before using it in a service configuration.

1. Open the project domain tools and Add a new domain.
2. Enter Domain name and click Continue.
3. Use Copy for the ownership TXT value shown.
4. Add the requested TXT record at your domain's DNS provider.
5. Return to the project and click Verify.

The domain is verified when the expected record is found. Enter the actual domain you control; do not reuse another project's verification value.

Assign a production service address

Choose the service address that users should recognize, then read the records for that exact destination.

1. Open the service's domain configuration.
2. Select the appropriate Verified domain.
3. Enter Subdomain for the intended service address.
4. Click Save or the linking action shown by the current form.
5. Read DNS record to add or DNS records to add for that service.

Use the name, type and value displayed for that service. Website, workspace and documentation are separate destinations.

The website and documentation can use different hostnames of one domain. Copy each service’s own name, type and target. A successful website check does not establish that the documentation hostname is correctly connected, and the ownership TXT record is not the address target.

Check the DNS connection

Complete the address records independently of the earlier ownership TXT check.

1. Add the displayed address record at your DNS provider.
2. Return to the corresponding service configuration.
3. Click Check the DNS record.
4. Read the resulting state.
5. Open the public service address after verification.

The connection check succeeds and the public hostname opens the intended service.

Note — DNS changes may not be visible immediately. If the first check fails, compare the record exactly and allow propagation before trying again.

Change an existing service address

Review links using the former address as part of the change, not only the new DNS record.

1. Open the address configuration for the correct service.
2. Use Change when a different domain or subdomain is required.
3. Review the new address and the DNS records it requests.
4. Complete verification and check the public destination.
5. Review website and documentation links that refer to the former address.

The new address works and the affected visitor journeys use the intended destination.

Remove a secondary domain

Remove a secondary domain you no longer need, for example one declared with a typo.

1. Under Secondary domains, find the domain and click Delete.
2. Check Domain name, then click Delete under Confirm the deletion.

The domain leaves your project; nothing changes at your registrar and you can declare it again later.

Note — The primary domain can't be removed, nor can a domain that still carries a production host. Point that service at another domain first.

Diagnose a failed check

Distinguish a failed ownership check from an address that does not reach the intended service.

Important — Copy the values from your project's current configuration. An example domain or another service's IP does not establish the required DNS destination.