Custom Domains

Use your own domain (e.g., app.yourcoaching.com) for a fully white-labeled experience.

Overview

Custom domains let you replace the default subdomain (yourslug.toolchat.ai) with your own branded domain. When members visit your custom domain, they see a fully branded experience with your logo, colors, and no ToolChat branding visible.

How It Works

your-domain.com → DNS → Cloudflare → Your ToolChat App

1. You add your domain in Settings
2. You configure DNS at your domain registrar
3. ToolChat verifies the DNS configuration
4. SSL certificate is automatically provisioned
5. Your app is now accessible at your custom domain

Setting Up a Custom Domain

Step 1: Add Your Domain

1. Go to Admin → Settings
2. Scroll to Custom Domain
3. Enter your domain (e.g., app.yourcompany.com)
4. Click Add Domain

Step 2: Configure DNS

You'll need to add a DNS record at your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.):

For Subdomains (Recommended)

Type	Name	Value
CNAME	app	yourslug.toolchat.ai

For Root/Apex Domains

Type	Name	Value
CNAME	@	yourslug.toolchat.ai

Use a Subdomain

We recommend using a subdomain like app.yourcompany.com rather than your root domain. This gives you flexibility to use your main domain for your marketing website.

Step 3: Verify Your Domain

1. Wait 5-15 minutes for DNS to propagate
2. Return to Admin → Settings
3. Click Verify Domain
4. If verification succeeds, your domain will show as "Verified"

Step 4: SSL Activation

After verification, an SSL certificate is automatically provisioned. This typically takes 2-10 minutes. Once active:

• Your custom domain works with HTTPS
• Members can access your app securely
• No additional configuration needed

Domain Status

Status	Meaning
Pending	Domain added, DNS not yet verified
Verified	DNS verified, SSL being provisioned
Active	Fully operational
Error	DNS verification failed

What Changes

Once your custom domain is active:

Before	After
yourslug.toolchat.ai	app.yourcompany.com
ToolChat login page	Branded login at your domain
Default social sharing	Custom OG tags with your branding

What stays the same:

• All your data and settings
• Member accounts
• Billing and subscriptions
• AI agents and knowledge base

Authentication

When you have a custom domain:

• Members log in at your custom domain
• Sessions work seamlessly across your domain
• Existing members will be redirected to your new domain

Cross-Domain Sessions

If a user logs in at toolchat.ai but is a member of your organization, they're automatically redirected to your custom domain after authentication.

Changing Your Slug

Important

If you have a custom domain and change your organization's slug, your custom domain will stop working until you:

1. Update your DNS to point to the new slug
2. Re-verify the domain

When you attempt to change your slug with an active custom domain, you'll see a warning explaining this impact.

Removing a Custom Domain

1. Go to Admin → Settings
2. Find the Custom Domain section
3. Click Remove Domain
4. Your app will revert to yourslug.toolchat.ai

Troubleshooting

DNS Not Verifying

Check your DNS records:

• Ensure the CNAME points to yourslug.toolchat.ai
• Wait longer—DNS can take up to 48 hours to propagate
• Check for typos in the domain or CNAME value

Using Cloudflare?

• Cloudflare automatically "flattens" CNAME records at the apex
• This is supported—verification checks both CNAME and A records

SSL Certificate Pending

After verification, SSL takes 2-10 minutes to provision. If it takes longer:

• Check that DNS is still correctly configured
• Try verifying again
• Contact support if issues persist

"Too Many Redirects" Error

This usually means:

• DNS is pointing to the wrong location
• There's a proxy/redirect configured at your registrar
• Clear browser cookies and try again

Domain Shows Error

1. Delete the domain from Settings
2. Re-add it
3. Verify DNS is correctly configured
4. Re-verify

Best Practices

Domain Choice

✅ Good choices:

• app.yourcompany.com
• members.yourcoaching.com
• portal.yourbrand.com

❌ Avoid:

• Using your main marketing domain directly
• Very long domains
• Domains you might want to change soon

Before Launch

• Set up your custom domain before inviting members
• Test the full member experience on your domain
• Verify emails are being sent with correct links

Marketing

Once your custom domain is active:

• Update all marketing materials with the new URL
• Use your custom domain in email signatures
• Share the branded URL on social media

DNS Provider Guides

Cloudflare

1. Log in to Cloudflare dashboard
2. Select your domain
3. Go to DNS → Records
4. Click Add record
5. Type: CNAME, Name: app, Target: yourslug.toolchat.ai
6. Click Save

GoDaddy

1. Log in to GoDaddy
2. Go to My Products → DNS
3. Click Add under Records
4. Type: CNAME, Name: app, Value: yourslug.toolchat.ai
5. Save

Namecheap

1. Log in to Namecheap
2. Go to Domain List → Manage
3. Click Advanced DNS
4. Add new CNAME record
5. Host: app, Target: yourslug.toolchat.ai

Google Domains

1. Log in to Google Domains
2. Select your domain
3. Go to DNS → Custom records
4. Add CNAME record
5. Host: app, Data: yourslug.toolchat.ai

FAQ

Can I use multiple custom domains? Currently, each organization can have one custom domain.

What happens to existing bookmarks? Links to your subdomain (yourslug.toolchat.ai) will continue to work and redirect to your custom domain.

Is SSL included? Yes, SSL certificates are automatically provisioned and renewed at no extra cost.

Can I use a domain I already own? Yes, as long as you can configure DNS for that domain.

Will emails come from my domain? Currently, system emails still come from ToolChat. Custom email domains may be added in the future.