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
- Open Domains and type the domain, for example
trade.yourname.com. Do not includehttps://or a port. Select Add domain. - The console shows the DNS records to create. They look like this:
| Type | Name (host) | Value |
|---|---|---|
| CNAME | trade.yourname.com | edge.<platform domain> (or a different target the console shows after provisioning) |
| TXT | _ob-verify.trade.yourname.com | ob-verify- followed by 32 characters |
Copy both values with the copy buttons. Do not retype them.
- 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.
- 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. - 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. - 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.
- Back in the console, select Check now on the domain. The platform also checks every 10 minutes.
What the status means
| Status | Meaning | What you do |
|---|---|---|
| Verifying DNS | We have not seen your TXT record yet | Check the records, wait, select Check now |
| Provisioning certificate | DNS is verified. The HTTPS certificate is being issued | Wait |
| Active | The domain serves your site over HTTPS | Nothing |
| Failed | DNS or the certificate did not complete within 24 hours | Fix the records, then select Check now to retry |
| Removing | You removed it | Nothing |
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
| Problem | Likely cause | Fix |
|---|---|---|
| Verifying DNS for a long time | The TXT name is wrong | The 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 found | You added quotes or spaces, or an old value | Delete the record and paste again |
| "Already registered" | The hostname is used by another terminal, or is yours already | Pick another hostname or remove the old entry |
| "Use a public hostname" | You entered a .local or .localhost name | Use a real domain |
| Apex domain refused | Apex needs flattening | Use a subdomain, or contact support about apex support |
| Certificate never issues | The proxy (orange cloud) is on, or a CAA record blocks issuance | Turn the proxy off. Add or relax the CAA record to allow Let's Encrypt |
| Browser warns about the certificate | Domain not yet Active | Wait for Active |
| Site shows "not found" on your domain | Domain not Active, or DNS points elsewhere | Check the status and the CNAME |
| Failed with no explanation | 24-hour timeout | Fix 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.