Custom Domain Setup Guide

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

Step 1: Add Your Domain in Postion

1. Go to Dashboard → Sites → Select your site
2. Navigate to Settings → Domains
3. Click "Add Custom Domain"
4. Enter your domain (e.g., blog.yourdomain.com or yourdomain.com)
5. 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:

Option B: Root Domain

For a root domain like yourdomain.com:

Step 3: Verify Your Domain

After configuring DNS:

1. Return to Settings → Domains in your Postion dashboard
2. Click "Verify" next to your domain
3. 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:

1. Click "Set as Primary" next to your custom domain
2. Your site will now use the custom domain as its main URL
3. The old yourname.postions.app URL will redirect to your custom domain

DNS Provider-Specific Instructions

Cloudflare

1. Log in to Cloudflare Dashboard → Select your domain
2. Go to DNS → Records
3. Add the CNAME record
4. Important: Set the proxy status to "DNS Only" (gray cloud), not "Proxied" (orange cloud)

Namecheap

1. Log in → Select your domain → Advanced DNS
2. Add a new CNAME record
3. Set Host to your subdomain and Value to cname.postions.app

Google Domains / Squarespace Domains

1. Navigate to DNS → Custom records
2. 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.