Overview
Agent widgets put a Taskade AI agent inside any website. Visitors see a small chat launcher in the corner, click to open a full conversation, and get answers grounded in your workspace knowledge. You get every conversation in your Agent Inbox.
TL;DR: Make an agent public, open the Embed tab, copy the snippet, and paste it before
</body>on your site. The widget handles brand colors, launcher position, and welcome text right from the panel. Pair it with Branded Agent Links so the popout opens on your own domain.
Generate the embed snippet
Build the snippet inside the agent's sharing panel, then paste it once on your site.
- Open the Agents tab and pick the agent you want to embed.
- Click Share in the top-right.
- Make sure the Public toggle is on. If it isn't, see Publish Agents Publicly.
- Switch to the Embed tab.
- Customize the launcher (color, position, welcome text).
- Click Copy snippet.
- Paste the snippet on your site, ideally right before the closing
</body>tag.
The snippet is one script tag plus one config object. No build step, no npm install, no frontend wiring. The widget loads asynchronously, so it never blocks your page.
Customize the look
Pick branding that matches your site without writing CSS.
- Launcher position: bottom-right or bottom-left.
- Brand color: pick a hex code or use your existing CSS variable.
- Avatar: upload a logo or use the agent's profile picture.
- Welcome message: the first thing a visitor reads when they open the widget.
- Suggested questions: up to four starter prompts to nudge the conversation.
- Theme: light, dark, or auto (matches the visitor's system preference).
Changes save instantly. Your live widget reflects the update on the visitor's next page load.
Behavior controls
Tune how the widget behaves so it helps, not interrupts.
| Setting | What it does | Default |
|---|---|---|
| Proactive open delay | Auto-opens the widget after N seconds on the page | Off |
| Mobile behavior | Show as full-screen modal or compact launcher on phones | Compact launcher |
| Sign-in prompt | Ask visitors for an email before they chat | Off |
| Max conversation length | Limit messages per visitor session | 30 messages |
| Cooldown after close | Stop the proactive prompt for N hours after dismissal | 24 hours |
Use the proactive delay carefully. A 5-second auto-open works on a pricing page where visitors expect questions. It feels intrusive on a blog post.
Where conversations land
Every visitor chat shows up in Agent Inbox, grouped by session. You can reply live while the visitor is on the page, hand off to a teammate, or let the agent finish on its own. Threads stay searchable forever, so you can mine them for product feedback, FAQ gaps, or support patterns.
Wire an automation to forward fresh threads to Slack, email, or your CRM. The trigger fires when a public chat ends, and the conversation history flows straight into the next step.
Use with branded domains
Pair the widget with Branded Agent Links so the popout opens on your domain, not taskade.com. Visitors stay on your-brand.com for the entire conversation, cookies stay on your origin, and your analytics tracking works without third-party-cookie warnings.
Set up the CNAME once, attach it to the agent, and the widget picks up the branded URL automatically.
Plan availability
Public widgets are available on Starter and above. Free workspaces can preview the widget inside Taskade but cannot publish it to a live site. Branded domains for the popout require Business or above. See pricing for the full plan matrix.
| Plan | Public widget | Branded domain |
|---|---|---|
| Free | Preview only | No |
| Starter | Yes | No |
| Pro | Yes | No |
| Business | Yes | Yes |
| Max | Yes | Yes |
| Enterprise | Yes | Yes |
Related guides
- Publish Agents Publicly — Required step before generating an embed snippet
- Use a Custom Domain for Agent Links — Open the widget on your own domain
- Public Agent Inbox — Read every visitor conversation in one place
- Custom AI Agents — Build the agent you want to embed
- Share & Embed AI Agents — The full sharing surface, including direct links and exports