Custom Domains

Replace your default yourapp.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 Pro 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:

Pro 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)	`custom.chipp.ai`

<Callout type="info"> We recommend using a subdomain (like `chat.`) rather than your root domain. This keeps your main website separate and makes DNS configuration simpler. </Callout>

Open Settings

Go to your app's Settings page. You'll see the Custom Domain card.

Enter Your Domain

Type your subdomain in the input field:

chat.yourbrand.com

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

Click Add

Chipp will verify your DNS configuration. If the CNAME record is found and points to custom.chipp.ai, your domain will be added.

DNS Configuration by Provider

Cloudflare

Go to your domain's DNS settings
Click Add Record
Select CNAME
Name: your subdomain (e.g., chat)
Target: custom.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: custom.chipp.ai
TTL: 1 Hour

Namecheap

Go to Domain List > Manage
Click Advanced DNS
Add new record:
- Type: CNAME
- Host: your subdomain
- Value: custom.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: custom.chipp.ai

Route 53 (AWS)

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

Verifying Your Setup

Check DNS Propagation

Use these tools to verify your DNS is configured:

Enter your full domain (e.g., chat.yourbrand.com) and check that CNAME records point to custom.chipp.ai.

Test Your Domain

Once DNS propagates:

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

Troubleshooting

"Could not find CNAME record"

Wait for propagation: DNS can take up to 48 hours (usually minutes)
Check record type: Must be CNAME
Check target: Should be exactly custom.chipp.ai

"CNAME record does not match"

Your CNAME is pointing somewhere else. Update it to point to custom.chipp.ai.

"Custom domain is already in use"

Another Chipp app is using this domain. Each domain can only be used by one app.

Domain Not Working After Adding

Remove proxy: If using Cloudflare, disable proxy (use DNS only)
Check DNS: Verify CNAME target is correct
HTTPS required: Access via https:// not http://

Removing a Custom Domain

To remove a custom domain:

Go to Settings
Click the trash icon next to your domain
Your app reverts to the default yourapp.chipp.ai URL

After removing, you should also delete the DNS record 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 yourapp.chipp.ai URL bookmarked as a backup in case of DNS issues.