Custom Domains

Replace your default yourbuild.chipp.ai URL with your own custom domain like chat.yourbrand.com. Custom domains make your AI chatbot feel like a native part of your brand.

ℹ️

Custom domains require a Builder plan or higher.

Why Use a Custom Domain?

Benefit	Description
Brand consistency	Keep users on your domain
Trust	Users stay in your branded environment
Professionalism	No third-party branding in the URL

Prerequisites

Before setting up a custom domain:

Builder plan or higher subscription
Own or control a domain name
Access to your domain’s DNS settings
A published Chipp app

Setting Up a Custom Domain

Add DNS Record First

Before configuring in Chipp, add this CNAME record at your domain registrar:

Type	Name	Value
CNAME	`chat` (or your subdomain)	`fallback.chipp.ai`

After you add the domain in Chipp (Step 4), you’ll also need to add a second CNAME record (at _acme-challenge. plus your subdomain) for SSL validation. Chipp will show you the exact record to add.

ℹ️

We recommend using a subdomain (like chat.) rather than your root domain. This keeps your main website separate and makes DNS configuration simpler.

Open Share

In the app builder, go to Launch > Share. You’ll see the Custom Domain card. Click Connect a domain.

Enter Your Domain

Type your subdomain in the input field:

plaintext

chat.yourbrand.com

Do not include https:// or www. in your domain.

Click Add

Chipp runs a quick check on the domain. If it looks parked, for sale, or unregistered, you’ll see a warning and the button changes to Add anyway. The check is advisory and does not block you.

After you add the domain, the card shows both DNS records: Route traffic to Chipp (the CNAME to fallback.chipp.ai) and Enable HTTPS (the _acme-challenge CNAME). Add both at your registrar. Your domain will not load over HTTPS until both records exist. SSL activates automatically once DNS propagates (typically 5-30 minutes). Click the refresh icon next to the domain to check its status.

DNS Configuration by Provider

Cloudflare

Go to your domain’s DNS settings
Click Add Record
Select CNAME
Name: your subdomain (e.g., chat)
Target: fallback.chipp.ai
Proxy status: DNS only (gray cloud)

⚠️

Disable Cloudflare’s proxy (orange cloud) for the subdomain. Use “DNS only” mode for custom domains to work correctly.

GoDaddy

Go to My Products > DNS
Click Add under Records
Type: CNAME
Name: your subdomain
Value: fallback.chipp.ai
TTL: 1 Hour

Namecheap

Go to Domain List > Manage
Click Advanced DNS
Add new record:
- Type: CNAME
- Host: your subdomain
- Value: fallback.chipp.ai

Google Domains / Squarespace Domains

Go to DNS in the sidebar
Scroll to Custom records
Create new record:
- Name: your subdomain
- Type: CNAME
- Data: fallback.chipp.ai

Route 53 (AWS)

Go to Hosted Zones > your domain
Click Create Record
Record name: your subdomain
Record type: CNAME
Value: fallback.chipp.ai

Visit your custom domain in a browser
You should see your Chipp chatbot
Check the SSL certificate (padlock icon)

Troubleshooting

Domain stuck on “pending”

The Custom Domain card diagnoses the problem and highlights the step to fix:

“Step 1 DNS record is missing or wrong”: set the CNAME for your subdomain to exactly fallback.chipp.ai
“Step 2 DNS record is missing” or “points to the wrong target”: add or fix the _acme-challenge CNAME using the target shown in the card
Wait for propagation: DNS can take up to 48 hours (usually minutes). Click the refresh icon to check again

”The domain is already registered”

This domain is already connected in Chipp. Each domain can only be used once.

Domain Not Working After Adding

Remove proxy: If using Cloudflare, disable proxy (use DNS only) on both records
Check DNS: Verify both CNAME records are present and correct
HTTPS required: Access via https:// not http://

Removing a Custom Domain

To remove a custom domain:

Go to Launch > Share
Click the trash icon next to your domain, then click Confirm
Your app reverts to the default yourbuild.chipp.ai URL

After removing, you should also delete both DNS records from your registrar.

Best Practices

Subdomain Naming

Choose a subdomain that makes sense:

Good	Why
`chat.brand.com`	Clear purpose
`ai.brand.com`	Modern, concise
`assistant.brand.com`	Descriptive
`help.brand.com`	Support-focused

Backup Access

Keep your default yourbuild.chipp.ai URL bookmarked as a backup in case of DNS issues.