Install the widget

Three minutes to add Guidia to your site.

≈ 3 min read

1. Get your snippet

From the Guidia console, open the relevant application then the “Install” tab. You'll find a snippet pre-filled with your widget_token and app_id.

2. Paste it into your HTML

Insert the tag in <head> or just before </body> on pages where the widget should show up. Loading is async and does not block rendering.

html

<script
  src="https://share.guidia.dev/loader.js"
  data-widget-token="WT_xxxxxxxxxxxxxxxx"
  data-app-id="APP_xxxxxxxxxxxx"
  data-locale="en"
  data-primary-color="#1A73E8"
  async
></script>

3. Available parameters

data-widget-token (required): your application's public key
data-app-id (required): application identifier
data-locale (optional): fr, en, ar, it, tr (or es, pt for tenant locale), default en
data-primary-color (optional): widget accent, default #6366f1
data-position (optional): bottom-right, bottom-left, etc.
data-user-token (optional): signed user JWT (see User auth)
data-api-url (optional): override backend URL (debug)

You can also set window.GuidiaConfig before loading the script for more complex configs (callbacks, initial context…).

4. Verification

Open the page in incognito to bypass cache.
Check that a floating button appears bottom-right.
Open the console: no Guidia warning should appear.
Verify your domain is in the “allowed domains” list.