Using Custom Domains

Connect your own domain name to your PageSmith site. Custom domains are available on Pro plans and above.

Setup Steps

1. Open your project in the AI Editor
2. Go to Workspace → Domains
3. Click "Add Custom Domain"
4. Enter your domain (e.g., www.example.com)
5. Choose your DNS configuration method
6. Update your DNS settings at your domain registrar
7. Wait for DNS propagation (usually 15 minutes to 24 hours)
8. Your site is live on your domain with automatic SSL!

DNS Configuration Methods

PageSmith supports two methods for connecting your domain:

Method 1: CNAME Record (Recommended)

Best for subdomains like www.example.com or blog.example.com.

At your domain registrar or DNS provider, add a CNAME record:

Example for www.example.com:

• Type: CNAME
• Name: www
• Target: sites.pagesmith.app

Example for blog.example.com:

• Type: CNAME
• Name: blog
• Target: sites.pagesmith.app

Method 2: Nameserver Delegation

Best for apex/root domains (example.com) or when you want PageSmith to fully manage your domain's DNS.

Update your domain's nameservers at your registrar to:

How to change nameservers:

1. Log in to your domain registrar (GoDaddy, Namecheap, Google Domains, etc.)
2. Find your domain's DNS or Nameserver settings
3. Replace existing nameservers with the PageSmith nameservers above
4. Save changes

Note: Nameserver changes can take up to 48 hours to propagate globally, though most complete within a few hours.

Supported Domains

• Top-level domains (.com, .org, .net, etc.)
• Subdomains (blog.example.com, shop.example.com)
• Apex/root domains (example.com) - requires nameserver method
• International domains (.de, .fr, .co.uk, etc.)
• Multiple domains per project (Business plan)

SSL Certificates

All custom domains automatically receive free SSL certificates:

• Automatic provisioning - SSL is set up when your domain is verified
• Auto-renewal - Certificates renew automatically before expiration
• HTTPS enforced - All traffic is automatically redirected to HTTPS

Verifying Your Domain

After updating your DNS settings:

1. Return to Workspace → Domains in the AI Editor
2. Click "Verify Domain"
3. PageSmith will check your DNS configuration
4. Once verified, your domain will show as "Active"

Verification may take a few minutes while DNS changes propagate. If verification fails, double-check your DNS settings and try again after a few minutes.

Troubleshooting

Domain Not Verifying

• Check DNS settings - Ensure CNAME points to sites.pagesmith.app or nameservers are set to ns1.pagesmith-dns.com and ns2.pagesmith-dns.com
• Wait for propagation - DNS changes can take up to 48 hours (use dnschecker.org to check)
• Check for typos - Verify the domain name is entered correctly
• Remove conflicting records - If using CNAME, remove any A records for the same subdomain

SSL Certificate Issues

• SSL certificates are provisioned after domain verification
• Allow up to 15 minutes for SSL to activate after verification
• If SSL isn't working, try re-verifying your domain

Site Shows Wrong Content

• Clear your browser cache
• Try accessing from an incognito/private window
• Verify the domain is connected to the correct project

Managing Multiple Domains

On Business plans, you can connect multiple domains to a single project:

1. Go to Workspace → Domains in the AI Editor
2. Click "Add Custom Domain" for each additional domain
3. Set one domain as your "Primary" domain
4. Other domains will redirect to the primary domain

Removing a Custom Domain

To disconnect a domain:

1. Go to Workspace → Domains in the AI Editor
2. Find the domain you want to remove
3. Click the delete/remove button
4. Confirm the removal

After removal, update your DNS settings at your registrar to avoid pointing to a non-existent site.