How to Connect Your Custom Domain

This guide will walk you through connecting your own domain (like yourbusiness.com) to your LocusPilot-generated website.

1Add Your Domain in the Dashboard

After your website generation is complete:

  1. Go to your project status page
  2. Find the "Custom Domain" section
  3. Enter your domain (e.g., example.com or www.example.com)
  4. Click "Add Domain"
Tip: We recommend using your root domain (example.com) for a shorter, cleaner URL. Both www and non-www domains are fully supported.

2Add CNAME Record at Your DNS Provider

After adding your domain, you'll see the DNS record you need to add. Go to your domain registrar or DNS provider and add the following record:

For root domain (example.com) - Recommended:

TypeName / HostValue / Target
CNAME@ (or leave empty)your-project.pages.dev

For www subdomain (www.example.com):

TypeName / HostValue / Target
CNAMEwwwyour-project.pages.dev

Replace your-project.pages.dev with the value shown in your dashboard.

3DNS Provider-Specific Instructions

GoDaddy

  1. Go to My Products > DNS
  2. Click Add under Records
  3. Select CNAME as the Type
  4. Enter @ for root domain, or www for subdomain
  5. Paste your pages.dev URL as the Points to value
  6. Click Save

Namecheap

  1. Go to Domain List > Manage
  2. Click Advanced DNS tab
  3. Click Add New Record
  4. Select CNAME as Type
  5. Enter @ for root domain, or www for subdomain
  6. Paste your pages.dev URL as Target
  7. Click Save All Changes

Cloudflare DNS (Important!)

  1. Go to your domain's DNS settings
  2. Click Add record
  3. Select CNAME as Type
  4. Enter @ for root domain, or www for subdomain
  5. Paste your pages.dev URL as Target
  6. Set Proxy status to "DNS only" (gray cloud icon)Do NOT use "Proxied" (orange cloud) - it will cause SSL/routing issues
  7. Click Save

Note: Cloudflare supports CNAME flattening for root domains automatically.

Other DNS Providers

The general steps are similar for most providers:

  1. Find the DNS management section
  2. Add a new CNAME record
  3. Set the host/name to @ for root domain, or www for subdomain
  4. Set the value/target to your pages.dev URL
  5. Save the changes

4Wait for DNS Propagation

DNS changes can take 1-24 hours to propagate worldwide. During this time, the domain status in your dashboard will show "Pending".

Click the "Check Status" button in your dashboard to verify when the domain is active.

Once verified: Your site will be live at your custom domain with automatic SSL/HTTPS enabled!

Root Domain vs www Subdomain

We recommend using your root domain (example.com) for a shorter, cleaner URL. Most modern DNS providers handle this seamlessly:

  • Cloudflare: Supports "CNAME flattening" automatically
  • Namecheap: Supports ALIAS records for root domains
  • GoDaddy: Supports CNAME flattening for root domains
  • Most providers: Support ALIAS/ANAME records as alternatives

If your DNS provider doesn't support root domain CNAME, you can usewww.example.com instead.

Troubleshooting

Domain still shows "Pending"

  • DNS propagation can take up to 24 hours
  • Verify the CNAME record is correct in your DNS settings
  • Clear your browser cache and try again

Using Cloudflare? Check proxy setting

  • The proxy status MUST be "DNS only" (gray cloud)
  • "Proxied" (orange cloud) will cause SSL/routing issues

SSL Certificate issues

  • SSL is automatically provisioned by Cloudflare
  • It may take a few minutes after domain verification
  • If issues persist, try removing and re-adding the domain

"Domain already connected" error

  • This domain may already be connected to another project
  • Remove it from the other project first, or use a different domain
Back to Dashboard