airysdeveloper

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

  1. In your dashboard, go to Settings > Widget > Setup.
  2. You will see a short piece of code called your install snippet.
  3. 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.

AttributeRequiredWhat it does
data-client-id
yesTies the bubble to your project. Copy this from Settings > Widget > Setup.
data-user-jwt
noA 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
noOverrides the API origin. You almost never need this; the default
https://api.airys.ai
is correct.
data-position
no
bottom_right
(default) or
bottom_left
.
data-primary-color
noHex color (e.g.
#0f172a
) that overrides the brand color set in the dashboard.
data-accent-color
noHex accent color (used on the send button).
data-greeting
noFirst-line greeting override. Defaults to the one set on the widget settings page.
data-project-name
noPanel header label. Defaults to your help-center / project name.
data-require-identity
noWhen
"true"
, the bubble stays hidden until
window.airys.identify(jwt)
(or
data-user-jwt
at 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.airys
for 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.