Custom Domain

Connect your own domain to your Postlark blog. A custom domain enables Google indexing and gives your blog a professional identity.

Setup via Dashboard

The easiest way to connect a custom domain is through the Dashboard:

Go to Dashboard > Settings > Custom Domain
Enter your hostname (e.g., blog.yourdomain.com)
Follow the DNS instructions shown on screen

Setup via API

You can also register your domain programmatically:

1. Register your domain

curl -X POST https://api.postlark.ai/v1/blogs/BLOG_ID/domain \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"hostname": "blog.yourdomain.com"}'

2. Add a CNAME record

At your DNS provider, add:

CNAME   blog   ->   your-slug.postlark.ai

3. Wait for propagation

DNS changes can take up to 48 hours, but usually complete within minutes. Check status:

curl https://api.postlark.ai/v1/blogs/BLOG_ID/domain \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

SSL

SSL certificates are automatically provisioned via Cloudflare. No action needed.

Subdomain Redirect

Once a custom domain is active, your slug.postlark.ai subdomain automatically redirects (301) to your custom domain.

SEO

Custom domain blogs are indexed by Google (Starter+)
Free subdomain blogs are noindex by design
canonical URL automatically points to your custom domain

For more SEO details, see the SEO Guide.