# Add a website address

> Tell CMS Orbit where each environment's website lives, verify it, and choose the primary address.

Source: https://docs.bifrostorbit.com/cms/developers/domains/

Open **Configuration › Domains**.

## What a domain is for

A domain tells CMS Orbit where an environment's website is published. CMS Orbit uses it to build full addresses for your pages: canonical links, sitemaps and hreflang. It also uses it to tell links to your own site from external ones when it checks for broken links.

It does not host or route your website. Visitors reach the site through your own DNS and hosting, and the website fetches its content with an API key, so the site works whether or not the domain is listed or verified here.

## Add and verify

1. Add the hostname, such as `www.example.com`, for an environment, and optionally a region and language.
2. Choose **Verify** on its row and copy the code shown. Add it to the domain's DNS as a TXT record, either on the hostname itself, such as `www.example.com`, or on `_cms-orbit.` followed by the hostname, such as `_cms-orbit.www.example.com`. Use the second if the hostname is a CNAME, which cannot carry other records.
3. Choose **Check DNS**. DNS changes can take a while to appear, so try again later if the record is not found yet. Verifying proves the address is yours, and only a verified domain can be made primary.

## Primary address

The primary domain is the canonical address for its environment, used in canonical links, sitemaps and hreflang. Making another one primary demotes the first, so there is never a tie.

## What is ignored

Scheme, path and port are stripped, so `https://www.example.com/de` and `www.example.com` are the same entry. Single names such as `localhost` are refused.

## Regions on one domain

Regions sharing a domain are told apart by their address prefix, such as `/de`, set on the region under **Configuration › Environments**.