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.
- Open your DNS host.
- Add a CNAME record for the subdomain you want (for example,
ask). - Point the value at
external.taskade.com. - Set TTL to Auto or 300 seconds for the fastest propagation.
- 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.
- Open the Agents tab and click the agent you want.
- Click Share in the top-right.
- Switch to the Domain tab.
- Paste the full subdomain (for example,
ask.your-brand.com). - Click Verify.
- 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.
Related guides
- Embed AI Agents as Website Widgets — The widget that opens on your branded domain
- Publish Agents Publicly — Required before attaching a domain
- Custom AI Agents — Build the agent before you brand it
- Public Agent Inbox — Track every conversation across every domain you attach
- Share & Embed AI Agents — Direct links, embed snippets, and export options
