The Helpdesky widget is a single <script> tag. It uses a Shadow DOM so your site CSS never leaks in.
1. Copy your snippet
Open Dashboard → Widget → Install and copy the snippet. It looks like this:
<script
src="https://helpdesky.io/widget.js"
data-helpdesk-id="YOUR_HELPDESK_ID"
></script>
2. Paste it before </body>
Paste it once, on every page where you want help available. The widget loads asynchronously and is < 30 KB gzipped.
3. Verify it loaded
You should see a floating bubble in the bottom-right of your page. Click it to open the panel.
Common tweaks
| Setting | What it does |
|---|---|
| Default tab | Open Search, Ask AI, or Message first |
| Pinned articles | Promote your top 3 articles to the top of search |
| Theme | Match your brand colors and dark mode |
| Allowed domains | Lock the widget to your own origins |
Heads up: if you set Allowed domains, the widget will silently refuse to load anywhere else. That's a feature, not a bug.
Watch the install walk-through: