Skip to content

Custom Domains ​

Use your own domain (e.g., app.yourcoaching.com) so your members get a fully white-labeled experience. Your own Build workspace, where VirtualJK coaches you on your business, is for owners and admins only and is not part of what members see.

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)

TypeNameValue
CNAMEappyourslug.toolchat.ai

For Root/Apex Domains

TypeNameValue
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 ​

StatusMeaning
PendingDomain added, DNS not yet verified
VerifiedDNS verified, SSL being provisioned
ActiveFully operational
ErrorDNS verification failed

What Changes ​

Once your custom domain is active:

BeforeAfter
yourslug.toolchat.aiapp.yourcompany.com
ToolChat login pageBranded login at your domain
Default social sharingCustom 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.