Skip to content

Your site

Custom domains

A custom domain lets clients use trade.yourname.com instead of slug.<platform domain>. Your platform address keeps working alongside it.

Before you start

  • You own a domain and can edit its DNS records (at your registrar, Cloudflare, etc.).
  • Your plan allows custom domains. Domains shows "Custom domains used" against your limit. If you are at the limit, adding fails ("You have reached your custom domain limit"). The platform operator sets the Free and Pro limits. Going back to Free never removes or disables a custom domain you already added.
  • Only admins and the owner can add or remove domains.
  • Hostnames are screened for brand impersonation. A name that imitates another brand is refused ("This domain cannot be used"). An internationalised (punycode) or look-alike name is held for review by the platform team ("This domain needs a quick review").
  • Use a subdomain (trade.yourname.com). Apex domains (yourname.com) need a DNS provider that supports CNAME flattening or ALIAS records, and need an extra confirmation in the console.
  • The domain must not end in the platform's own domain.

Step by step

  1. Open Domains and type the domain, for example trade.yourname.com. Do not include https:// or a port. Select Add domain.
  2. The console shows the DNS records to create. They look like this:
TypeName (host)Value
CNAMEtrade.yourname.comedge.<platform domain> (or a different target the console shows after provisioning)
TXT_ob-verify.trade.yourname.comob-verify- followed by 32 characters

Copy both values with the copy buttons. Do not retype them.

  1. Open your DNS provider's DNS page. Most providers show a table with columns Type, Name or Host, Value or Target or Content, and TTL. Click Add record.
  2. Add the CNAME: choose type CNAME, enter the name. Many providers want only the part before your domain (trade), not the full name. Paste the target. Leave TTL on Auto or 300.
  3. Add the TXT: choose type TXT, name _ob-verify.trade (again, some providers want it relative to your domain), value is the token exactly as shown, with no quotes added by you.
  4. If your DNS is on Cloudflare, set the CNAME to "DNS only" (grey cloud, not orange). A proxied record can stop the certificate from being issued.
  5. Back in the console, select Check now on the domain. The platform also checks every 10 minutes.

What the status means

StatusMeaningWhat you do
Verifying DNSWe have not seen your TXT record yetCheck the records, wait, select Check now
Provisioning certificateDNS is verified. The HTTPS certificate is being issuedWait
ActiveThe domain serves your site over HTTPSNothing
FailedDNS or the certificate did not complete within 24 hoursFix the records, then select Check now to retry
RemovingYou removed itNothing

How long it takes

  • DNS changes usually appear within minutes. Some providers need up to a few hours, because the old value is cached for its TTL.
  • After DNS is correct, the certificate usually issues within an hour.
  • The platform stops waiting after 24 hours and marks the domain Failed. You can retry.
  • You get an email when the domain becomes active or fails (verified email only).

Troubleshooting

ProblemLikely causeFix
Verifying DNS for a long timeThe TXT name is wrongThe TXT name must be _ob-verify. plus the full hostname you added. If your provider appends your domain automatically, enter only _ob-verify.trade
TXT value not foundYou added quotes or spaces, or an old valueDelete the record and paste again
"Already registered"The hostname is used by another terminal, or is yours alreadyPick another hostname or remove the old entry
"Use a public hostname"You entered a .local or .localhost nameUse a real domain
Apex domain refusedApex needs flatteningUse a subdomain, or contact support about apex support
Certificate never issuesThe proxy (orange cloud) is on, or a CAA record blocks issuanceTurn the proxy off. Add or relax the CAA record to allow Let's Encrypt
Browser warns about the certificateDomain not yet ActiveWait for Active
Site shows "not found" on your domainDomain not Active, or DNS points elsewhereCheck the status and the CNAME
Failed with no explanation24-hour timeoutFix the records, then select Check now

Check your records from any terminal:

nslookup -type=TXT _ob-verify.trade.yourname.com
nslookup -type=CNAME trade.yourname.com

Provider details

  • The platform's hosting provider may show its own CNAME target after provisioning. If so, the console replaces the target with that value. Use the value the console shows now, not an old copy.
  • If the console lists an additional verification record for the provider, add it too.
  • The number of custom domains the platform can host is limited by its provider. If the platform is full, adding may fail. Contact support.

Removing a domain

Select Remove next to the domain and confirm. If you turned on 2FA, you are asked for a code. The hostname stops serving your site. Delete your DNS records afterwards to avoid leaving a dangling CNAME that someone else could claim.

Moving to another terminal or platform

Remove the domain here first, then add it in the new place. Hostnames are unique across the platform.