# Use a Custom Domain for Agent Links

> Point your own domain at an AI agent. Visitors land on your-brand.com instead of taskade.com. Same agent, your URL bar.

- Source: https://www.taskade.com/learn/agents/branded-links
- Section: AI Agents
- Updated: 2026-09-28
- Index of all pages: https://www.taskade.com/learn/llms.txt

## 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](https://www.taskade.com/learn/agents/agent-widgets) 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](https://www.taskade.com/learn/agents/public-agents) 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 do not 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 do not 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](https://www.taskade.com/learn/agents/agent-widgets) 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 has not 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 is not attached to a public agent, or public access is off | Open the agent's **Publish** tab. Make sure that **Publish Agent** is on and that your domain is picked in the **Agent Share Link** menu on the **Share** tab |

If the green check still does not 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](https://www.taskade.com/learn/agents/agent-widgets). The widget that opens on your branded domain.
- [Publish Agents Publicly](https://www.taskade.com/learn/agents/public-agents). Required before attaching a domain.
- [Custom AI Agents](https://www.taskade.com/learn/agents/custom-agents). Build the agent before you brand it.
- [Public Agent Inbox](https://www.taskade.com/learn/agents/agent-inbox). Track every conversation across every domain you attach.
- [Share & Embed AI Agents](https://www.taskade.com/learn/agents/sharing). Direct links, embed snippets, and export options.
