custom domains

any folder on sublimated can have its own domain. two options: a *.sublimated.com subdomain or your own custom domain.

sublimated subdomain

claim a subdomain like kanapka.sublimated.com for any folder.

option 1 — add to .sbl/config.yml in the folder:

subdomain: kanapka

push the file and the subdomain is live immediately.

option 2 — use the settings UI on sublimated.com (folder settings > domains).

option 3 — API:

curl -X POST https://api.sublimated.com/v1/spaces/yourspace/subdomains \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "kanapka", "url_path": "sites/kanapka"}'

subdomain rules: 3-63 chars, lowercase alphanumeric and hyphens, no leading/trailing hyphens.

custom domain

use your own domain (e.g. mysite.com) for any folder.

option 1 — add to .sbl/config.yml:

domain: mysite.com

option 2 — use settings UI or API.

after adding the domain, set up DNS:

1. add a CNAME record pointing your domain to run.sublimated.com

2. if you want www.mysite.com too, add a CNAME for www pointing to run.sublimated.com

mysite.com     CNAME  run.sublimated.com
www.mysite.com CNAME  run.sublimated.com

SSL is provisioned automatically via Cloudflare. verification usually completes in a few minutes.

you can check domain status in the settings UI or via API:

curl https://api.sublimated.com/v1/spaces/yourspace/domains \
  -H "Authorization: Bearer $TOKEN"

which folders support domains?

any folder that serves web content: zola sites, mdx pages, or any folder with an index.html. the domain maps to the folder — all files inside are served under that domain.

live example

kanapka.sublimated.com — a zola food blog with a sublimated subdomain.

faq · all docs