Custom Domain Setup Guide
Connect your own domain to your Postion site. Step-by-step instructions for DNS configuration, SSL certificates, and troubleshooting common issues.
Using a custom domain gives your site a professional identity. Instead of yourname.postions.app, your audience will see blog.yourdomain.com or yourdomain.com.
Prerequisites
- A registered domain name (purchased from providers like Namecheap, Cloudflare, GoDaddy, or Google Domains)
- Access to your domain's DNS settings
- A Pro or Premium Postion plan
Custom domains are available on paid plans. Upgrade your plan if you're on the free tier.
Step 1: Add Your Domain in Postion
- Go to Dashboard → Sites → Select your site
- Navigate to Settings → Domains
- Click "Add Custom Domain"
- Enter your domain (e.g.,
blog.yourdomain.comoryourdomain.com) - Click "Add"
Postion will display the DNS records you need to configure.
Step 2: Configure DNS Records
Option A: Subdomain (Recommended)
For a subdomain like blog.yourdomain.com:
| Type | Name | Value | TTL |
|---|---|---|---|
| CNAME | blog | cname.postions.app | 3600 |
Option B: Root Domain
For a root domain like yourdomain.com:
| Type | Name | Value | TTL |
|---|---|---|---|
| A | @ | (IP provided in dashboard) | 3600 |
| CNAME | www | cname.postions.app | 3600 |
DNS changes can take up to 48 hours to propagate globally, but most providers update within 1-4 hours. Don't panic if your domain doesn't work immediately.
Step 3: Verify Your Domain
After configuring DNS:
- Return to Settings → Domains in your Postion dashboard
- Click "Verify" next to your domain
- Postion will check your DNS records and confirm the connection
Step 4: SSL Certificate
Postion automatically provisions a free SSL certificate for your custom domain via Let's Encrypt. This happens within a few minutes of successful DNS verification.
Your site will be accessible via https:// automatically — no extra configuration needed.
Step 5: Set as Primary Domain
Once verified:
- Click "Set as Primary" next to your custom domain
- Your site will now use the custom domain as its main URL
- The old
yourname.postions.appURL will redirect to your custom domain
DNS Provider-Specific Instructions
Cloudflare
- Log in to Cloudflare Dashboard → Select your domain
- Go to DNS → Records
- Add the CNAME record
- Important: Set the proxy status to "DNS Only" (gray cloud), not "Proxied" (orange cloud)
Namecheap
- Log in → Select your domain → Advanced DNS
- Add a new CNAME record
- Set Host to your subdomain and Value to
cname.postions.app
Google Domains / Squarespace Domains
- Navigate to DNS → Custom records
- Add the CNAME record as shown above
Troubleshooting
"Domain not verified"
- Double-check that the DNS records match exactly what's shown in your dashboard
- Wait at least 1 hour for DNS propagation
- Use dnschecker.org to verify your records have propagated
"SSL certificate not issued"
- Ensure your DNS is pointing correctly (not through a CDN proxy)
- Wait up to 30 minutes after DNS verification for SSL provisioning
- If using Cloudflare, make sure proxy is set to DNS Only
"Site shows default page"
- Clear your browser cache and try again
- Try accessing the domain in an incognito/private window
- Contact support if the issue persists after 24 hours
For more technical details on how custom domains work under the hood, see our Custom Domain Architecture documentation.