37 unmodified lines
38```
39
40option 2 — use settings UI or API.
41
42after adding the domain, set up DNS:
42after adding the domain, set up DNS at your provider. the exact record depends on whether you're using an apex domain (like `mysite.com`) or a subdomain (like `blog.mysite.com`).
43
441. add a CNAME record pointing your domain to `run.sublimated.com`
452. if you want `www.mysite.com` too, add a CNAME for `www` pointing to `run.sublimated.com`
44### subdomain (blog.mysite.com, docs.mysite.com)
45
46add a CNAME record — this works on all DNS providers:
47
48```
48mysite.com     CNAME  run.sublimated.com
49www.mysite.com CNAME  run.sublimated.com
49blog.mysite.com  CNAME  run.sublimated.com
50```
51
52### apex / naked domain (mysite.com)
53
54apex domains can't have standard CNAME records (DNS spec limitation). you have two options depending on your provider:
55
56option 1 — CNAME flattening (recommended if your provider supports it):
57
58```
59mysite.com  CNAME  run.sublimated.com
60```
61
62providers that support this: Cloudflare, Vercel DNS, Netlify DNS, Bunny DNS.
63
64option 2 — ALIAS / ANAME record (same effect, different name):
65
66```
67mysite.com  ALIAS  run.sublimated.com
68```
69
70providers that support ALIAS: Route53 (AWS), DNSimple, DNS Made Easy, NS1.
71
72option 3 — TXT verification (if your provider doesn't support CNAME flattening or ALIAS):
73
74add a TXT record for domain ownership verification. the value is shown after you add the domain in the UI or API response:
75
76```
77_cf-custom-hostname.mysite.com  TXT  <your-hostname-id>
78```
79
80providers where you need TXT: GoDaddy, Namecheap, Google Domains, Hover, Porkbun.
81
82note: with TXT verification the domain still works — Cloudflare routes traffic via the Custom Hostname. you just can't use a CNAME at the root.
83
84### www
85
86if you want `www.mysite.com` too, add a CNAME for `www`:
87
88```
89www.mysite.com  CNAME  run.sublimated.com
90```
91
92SSL is provisioned automatically via Cloudflare. verification usually completes in a few minutes.
93
94you can check domain status in the settings UI or via API:
95
16 unmodified lines