# Setting up a custom domain

> Add a custom domain to your organization, create its ownership and routing DNS records, and verify it.

## Before you start

* Your organization’s plan includes a custom domain. Free includes one; Identity Plus and Team Plus include unlimited custom domains. See [Custom domains](/en/custom-domains#what-each-plan-includes).
* You are the organization’s **owner** or an **admin**.
* You can create DNS records for the domain at your registrar or DNS provider.
* You have decided which address to use. A subdomain such as `secrets.example.com` is recommended: it uses a CNAME record, which keeps working if the service’s addresses change. An apex domain such as `example.com` needs an A record pointing at a fixed IP address.

## Add the domain

1. Sign in, open the user menu and choose **Domains**. This opens your organization’s settings on the **Domains** tab. The domain belongs to the organization whose settings are open.
2. Choose **Add domain**.
3. In **Custom domain**, enter the address, for example `secrets.example.com`. If you enter an apex domain such as `example.com`, you are asked where secret links should live: pick one of the **Popular subdomains**, or choose **Use my root domain**.
4. Choose **Continue with** *your domain*.

The domain is added to the organization, and the next screen lists the two DNS records to create. There is no region choice: the records point at the regional site your organization uses. See [Where your domain is served](/en/custom-domains#where-your-domain-is-served).

## Create the DNS records

Create both records in your DNS provider. Copy the values from the domain’s verification page; the examples below only show their form.

### Ownership record (TXT)

This record proves that you control the domain. Verification depends on it.

* **Host:** `_onetime-challenge-` followed by a short identifier for your domain. For a subdomain, the subdomain is added after it. For example, `_onetime-challenge-abc1234` for `example.com`, or `_onetime-challenge-abc1234.secrets` for `secrets.example.com`. Create it in the zone of the base domain (`example.com`).
* **Value:** a 32-character hexadecimal code.

Some providers expect only the host label and add the zone for you; others expect the full name. Either form is fine as long as the record resolves at `<host>.<your base domain>` and returns the value unchanged. It must be the only TXT record at that name: remove values left from an earlier attempt.

The value stays the same while the domain is in your organization. If you remove the domain and add it again, it gets a new value, and usually a new host.

Keep this record after verification. Verification is repeated in the background, and a check that no longer finds the record stops the domain being served.

### Routing record (CNAME or A)

This record sends visitors to Onetime Secret.

* **Subdomain:** a CNAME record from your subdomain (for example `secrets`) to the target shown on the verification page.
* **Apex domain:** an A record for `@` (or a blank host, depending on your provider) with the IP address shown on the verification page.

For reference, these are the targets for each regional site:

| Region                           | CNAME target | A record address                                    |
| -------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------- |
| Canada                           | `identity.ca.onetime.co`           | As shown on the verification page |
| European Union     | `identity.eu.onetime.co`           | `109.105.217.207`                                                               |
| Aotearoa New Zealand | `identity.nz.onetime.co`           | As shown on the verification page |
| United Kingdom     | `identity.ingress.onetime.co`      | As shown on the verification page     |
| United States        | `identity.us.onetime.co`           | `66.51.126.41`                                                                  |

Remove any other A, AAAA or CNAME records for the same host. Do not remove the TXT ownership record; it is not a conflict.

## Verify the domain

1. On the **Domains** tab, open the domain’s menu and choose **Verify Domain**, or select the domain’s status. On the verification page, choose **Verify Domain**. The button can be used again after a short pause.
2. The service also re-checks domains in the background, so verification can finish without you pressing the button. DNS changes often take effect within minutes, but can take a day or longer, depending on your DNS provider and the records’ time to live (TTL).

Verification succeeds when the TXT record is found. The domain is then served, and you can choose it when you create a secret. The routing record and the certificate are tracked separately; see [DNS validation](/en/custom-domains/dns-validation) for each stage and the status labels.

## Check the result

When the domain is ready, the Domains tab shows a check mark next to it, with the tooltip **Domain verified and active**, and the domain’s own page shows **Active**. A domain that needs attention shows its status as text on the Domains tab instead.

After a check has run, the domain’s verification page shows a **Domain Status** panel with these fields:

* **Domain**: the domain name.
* **Status**: the latest result reported for the domain.
* **Target Address**: on some setups, where the service routes the domain internally. It is not a value to enter in your DNS.
* **DNS Record**: where your domain pointed at the last check.
* **SSL Status**: whether a certificate is active.
* **SSL Renews**: the current certificate’s expiry date. The service renews the certificate before then; you do not need to do anything.
* **Last Monitored**: when the domain was last checked.
* **Last verification check failed**: shown only when the latest check could not complete.

## Use the domain

When you create a secret while signed in, choose the domain you are creating under. The secret link then uses your domain, for example `https://secrets.example.com/secret/abc123`.

## Questions or need support?

Email <support@onetimesecret.com> or use the [feedback form](https://onetimesecret.com/feedback).