Installing the widget on your site
Adding the airys chat bubble to your website takes one copy and one paste. You do not need any coding skills beyond that, and you only have to do it once.
Find your install snippet
- In your dashboard, go to Settings > Widget > Setup.
- You will see a short piece of code called your install snippet.
- Click to copy it.
This snippet is yours alone. It carries a unique ID that ties the bubble to your project, so your visitors always get your articles, your branding, and your reports.
Paste it into your website
Add the snippet to the pages where you want the chat bubble to appear. The best place is right before the closing
</body>tag, so it loads last and your page shows up first.
Here is what the snippet looks like:
<script src="https://widget.airys.com/loader.js" data-client-id="YOUR-CLIENT-ID"></script>
Your real snippet will already have your own ID filled in where the placeholder is, so you can paste it exactly as you copied it.
See the bubble appear
Once the snippet is in place, save and publish your page, then open your site. The chat bubble shows up in the corner, ready to answer questions.
A few things to know
- It loads quietly. The snippet works in the background and will not slow your page down for visitors.
- One snippet covers your whole site. If your pages share a common footer or template, paste it there once and the bubble appears everywhere.
- Need to add it to every page by hand? Just drop the same snippet before the closing
</body>
tag on each page.
That is it. After you publish, your customers can start chatting right away, and you can keep managing everything from your dashboard.
All the options you can set on the snippet
The snippet from your dashboard already has the only required attribute (
data-client-id). If you want to tweak how the widget loads — pin its colors, identify your logged-in users, override the position — you can add more
data-*attributes to the same
<script>tag.
| Attribute | Required | What it does |
|---|---|---|
data-client-id | yes | Ties the bubble to your project. Copy this from Settings > Widget > Setup. |
data-user-jwt | no | A short-lived JWT your backend signs to identify the logged-in visitor. See Identifying your users. For single-page apps, prefer window.airys.identify(jwt)instead. |
data-api-base | no | Overrides the API origin. You almost never need this; the default https://api.airys.aiis correct. |
data-position | no | bottom_right(default) or bottom_left. |
data-primary-color | no | Hex color (e.g. #0f172a) that overrides the brand color set in the dashboard. |
data-accent-color | no | Hex accent color (used on the send button). |
data-greeting | no | First-line greeting override. Defaults to the one set on the widget settings page. |
data-project-name | no | Panel header label. Defaults to your help-center / project name. |
data-require-identity | no | When "true", the bubble stays hidden until window.airys.identify(jwt)(or data-user-jwtat boot) successfully verifies an identity. Useful when the widget should only appear for logged-in visitors. |
Anything you set on the snippet wins over the server-side settings — handy when you're testing a color without saving it for everyone.
Loading the widget from JavaScript (SPAs)
If your site is a single-page app, or you only want the widget to appear after a user logs in, you'll inject the snippet from your own code instead of putting it directly in the HTML. The widget exposes a small JavaScript API at
window.airysfor that. See Controlling the widget from JavaScript for the full lifecycle (inject, identify, refresh, shut down).
For logged-in visitors: call
window.airys.identify(jwt)from your auth-resolved callback that fires on page load — not after the user opens the widget. The widget attaches the contact at the moment the conversation is created; if identify lands later, that conversation stays anonymous in your dashboard. See Letting airys know who your signed-in users are for the full timing rule.