download dots
Use a Custom Domain for Agent Links

Use a Custom Domain for Agent Links

Updated 2026-05-06·4 min read
On this page (8)

Overview

Branded links replace the default taskade.com/a/{slug} URL with your own domain. Same agent, your branding in the URL bar. Pair this with the agent widget and visitors never leave your origin during a conversation.

TL;DR: Add a CNAME record at your DNS host pointing to external.taskade.com, then open Agent → Share → Domain and confirm. Taskade provisions free SSL and your agent is reachable at the branded URL within minutes. Available on Business and above. See Publish Agents Publicly to make sure the agent is public first.


Set the CNAME

Open your DNS host (Cloudflare, GoDaddy, Namecheap, Route 53, anywhere you manage your domain) and add one record.

  1. Open your DNS host.
  2. Add a CNAME record for the subdomain you want (for example, ask).
  3. Point the value at external.taskade.com.
  4. Set TTL to Auto or 300 seconds for the fastest propagation.
  5. Save.

Most DNS hosts publish the change within 1 to 5 minutes. A few legacy registrars take up to an hour. You don't need to delete or change any other records on the domain.


Attach the domain to the agent

Once the CNAME is live, link it to the agent inside Taskade.

  1. Open the Agents tab and click the agent you want.
  2. Click Share in the top-right.
  3. Switch to the Domain tab.
  4. Paste the full subdomain (for example, ask.your-brand.com).
  5. Click Verify.
  6. Wait for the green check.

Verification usually takes under a minute. Once it lands, your agent is reachable at https://ask.your-brand.com with valid SSL.


SSL and renewal

You don't need to upload a certificate or renew anything. Taskade handles SSL automatically.

  • SSL certificates are issued through a public certificate authority on first verification.
  • Certificates renew every 60 days, well before expiry.
  • HTTPS is enforced. Plain HTTP requests redirect to HTTPS automatically.
  • Modern TLS (1.2 and 1.3) is supported. Older protocols are disabled.

If your domain is behind Cloudflare or another proxy, set the SSL mode to Full (Strict) so the proxy validates Taskade's certificate end to end.


Use with widgets

When a widget is embedded, the popout view loads from the branded domain so cookies and analytics stay on your origin. That means:

  • First-party cookies work without cross-site warnings.
  • Your existing analytics (Plausible, GA4, PostHog) attribute the chat session to your domain.
  • Browser permission prompts (camera, mic, file upload) say "your-brand.com" instead of "taskade.com".
  • Email links and screenshots show your URL, which builds trust.

No extra config. Once the domain is verified, the widget picks it up automatically.


One domain, many agents

Use a single root domain (for example, ask.your-brand.com) and route to multiple agents by path: /sales, /support, /onboarding. Set the routes in the Domain panel.

Path Agent Use it for
/ Default agent The general-purpose assistant
/sales Sales agent Pricing, demos, lead capture
/support Support agent Product help, troubleshooting
/onboarding Onboarding agent New customer walkthroughs

Each path runs an independent conversation thread, with its own tools, knowledge, and Inbox. Switch agents by editing the path map. No DNS changes needed.


Common DNS issues

Most setup problems trace back to one of three patterns. The fix is usually fast.

Symptom Likely cause Fix
Verification still says Configuring after 10 minutes DNS hasn't propagated, or the CNAME points somewhere else Run dig CNAME ask.your-brand.com and confirm it resolves to external.taskade.com
Browser shows an SSL warning Certificate is still being issued, or a proxy is intercepting traffic Wait 5 minutes after verification. If using Cloudflare, set SSL mode to Full (Strict)
Branded URL redirects back to taskade.com The domain isn't attached to a public agent, or public access is off Open Share and confirm both Public access and the Domain are enabled

If the green check still doesn't appear, drop a note in the support chat with your domain. Most cases resolve in under an hour.