Skip to content

You're viewing the prerelease documentation siteContent here is for testing and may differ from the live docs.

Go to live docs

Setting up a custom domain

  • Your organization’s plan includes a custom domain. Free includes one; Identity Plus and Team Plus include unlimited custom domains. See Custom domains.
  • 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.
  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.

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

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.

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.

  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 for each stage and the status labels.

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.

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.

Email support@onetimesecret.com or use the feedback form.