blog.example.com) to any public site or service running on your Zo. This gives your projects a professional, branded URL instead of the default yoursite-handle.zocomputer.io.
Custom domains are available on paid plans. See pricing for plan limits.
How it works
When you add a custom domain, we:- Register your domain with Cloudflare’s edge network
- Automatically provision and manage a TLS certificate for HTTPS
- Route all traffic from your domain to your service
Adding a custom domain
1
Open Sites
Navigate to the Sites page in your Zo and find the service you want to add a domain to.
2
Add domain
Expand the service details and click Add domain in the Custom Domains section. Enter your domain (e.g.,
blog.example.com).3
Configure DNS
Add a CNAME record in your domain’s DNS settings:
| Type | Name | Target |
|---|---|---|
| CNAME | blog (or @ for subdomains) | cname.zocomputer.io |
4
Wait for verification
Once your CNAME is configured, Zo will automatically detect it and provision your TLS certificate. This usually takes 1-15 minutes.
Domain status
Your custom domain goes through these states:| Status | Description |
|---|---|
| Pending CNAME | Waiting for you to add the CNAME record |
| Pending SSL | CNAME verified, TLS certificate being provisioned |
| Active | Domain is live and serving traffic |
| Error | Something went wrong (check DNS configuration) |
Limitations
-
Subdomains only: You must use a subdomain like
blog.example.comorapp.example.com. Apex domains (likeexample.com) are not supported because they cannot have CNAME records. -
Plan limits: The number of custom domains you can add depends on your plan:
Plan Custom Domains Free 0 Basic 3 Pro 5 Ultra 10 - One domain per service: Each custom domain can only point to one service at a time. You can transfer a domain to a different service without re-verification.
Troubleshooting
Domain stuck on 'Pending CNAME'
Domain stuck on 'Pending CNAME'
DNS changes can take time to propagate. Wait a few minutes and click Verify now. You can also check your CNAME record using a DNS lookup tool:The result should show
cname.zocomputer.io as the target.Domain stuck on 'Pending SSL'
Domain stuck on 'Pending SSL'
TLS certificate provisioning typically takes 1-15 minutes. If it’s been longer than an hour, check:
- CAA records: If your domain has CAA DNS records, ensure they allow
digicert.comandletsencrypt.org. - Conflicting proxies: If your domain is already proxied through another Cloudflare zone, you may need to disable that proxy first.
SSL certificate errors in browser
SSL certificate errors in browser
If you see certificate warnings after the domain shows as Active:
- Wait a few more minutes for certificate propagation
- Try a hard refresh (Cmd+Shift+R or Ctrl+Shift+R)
- Try an incognito/private browser window
Domain was working but now shows errors
Domain was working but now shows errors
If your domain stops working:
- Verify the CNAME record is still configured correctly
- Check that your service is still running
- Remove and re-add the domain if the issue persists