Skip to main content

Overview

You can point your own domain (or subdomain) to any Supalink site. SSL certificates are provisioned automatically.
PlanCustom Domains
Free1
Hobby ($4/mo)5

Setup

Step 1: Add the domain in your dashboard

  1. Go to supalink.dev/dashboard
  2. Click the Domains tab
  3. Click + Add Domain
  4. Enter your domain (e.g., docs.mysite.com)

Step 2: Configure DNS

Add these DNS records at your domain registrar or DNS provider:

CNAME Record

TypeNameTarget
CNAMEdocs (or your subdomain)proxy.supalink.dev

TXT Record (verification)

TypeNameValue
TXT_supalink.docs (or _supalink.yoursubdomain)The verification code shown in the dashboard

Step 3: Wait for verification

DNS changes can take up to 48 hours to propagate, but typically complete within a few minutes. The domain status in your dashboard will change from Pending to Active once verified.

Using a Root Domain

For root/apex domains (e.g., mysite.com without a subdomain), you need a DNS provider that supports CNAME flattening or ALIAS records:
  • Cloudflare — Supports CNAME flattening (use CNAME at root)
  • Route 53 — Use an ALIAS record
  • DNSimple — Use an ALIAS record
Not all DNS providers support this. If yours doesn’t, use a subdomain like www.mysite.com instead.

SSL Certificates

SSL certificates are provisioned and renewed automatically through Cloudflare. You don’t need to do anything — HTTPS just works once the domain is verified.

Managing Domains via API

You can also manage custom domains through the API:
# List your domains
curl -X GET https://supalink.dev/api/v1/domains \
  -H "Authorization: Bearer sl_live_your_key_here"

# Add a domain
curl -X POST https://supalink.dev/api/v1/domains \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sl_live_your_key_here" \
  -d '{"domain": "docs.mysite.com", "siteSlug": "bright-canvas-a7k2"}'

# Remove a domain
curl -X DELETE https://supalink.dev/api/v1/domains/docs.mysite.com \
  -H "Authorization: Bearer sl_live_your_key_here"