Embedding the widget
Once the widget is styled, install it on your website. Open Dashboard → Widget → Install to get your embed code, copy it, and paste it into your site.
Copy the embed code
The Install page shows the snippet in two tabs:
- Script Tag (Recommended) — a floating chat bubble that opens into the chat window.
- iFrame — embeds the chat inline on a page.
Click Copy to copy the active snippet. The script tag looks like this:
html<script src="https://your-promptly-host/widget/embed.js" data-tenant="your-tenant-slug" data-style="modern" data-api-base="https://your-promptly-host" async ></script>
The
data-tenantdata-styleasyncWhere to paste it
Paste the script just before the closing </body>
🎬 [Video] — Pasting the script before
, reloading the page, and sending the first chat message.text</body>
Shadow DOM isolation
The widget renders inside a Shadow DOM host with the chat itself in an isolated iframe. This means your site's CSS cannot leak into the widget and the widget's styles cannot affect your page — so the appearance you set in the customizer is exactly what visitors see, on any site.
Turning it on and off
The master switch is Dashboard → Settings → Widget enabled. Turn it off to instantly hide the widget everywhere without removing the script. You do not need to edit your site to disable the widget.
Troubleshooting: bubble not showing
If the chat bubble does not appear, check, in order:
- Widget enabled? Confirm Settings → Widget enabled is on.
- Domain approved? The widget only loads on approved domains. Add your site (and for local testing) under Allowed Domains on the Install page. See Origin guard & rate limiting.text
localhost - Correct keys/slug? Make sure matches your tenant slug andtext
data-tenantpoints at your Promptly host. See API keys & encryption.textdata-api-base - Console errors? Open your browser's developer console and look for errors from .text
embed.js
🖼️ [Image] — The Install page with the Script Tag snippet, platform tabs, and Allowed Domains editor.