Install the chatbot

How do I add the chatbot to my website?

In the dashboard, open Embed. It gives you a public key and the snippet below. Paste it before the closing </body> tag of your site — on every page you want the bubble to appear.

<script src="https://grounly.com/widget.js"
        data-key="pk_live_…" async></script>

The key is public by design. It identifies your bot, it is not a secret, and it is safe in page source — which is why the domain allowlist below matters.

Can someone copy my key and run the bot on their site?

No. You list the domains the bot may run on, and that check happens on the server. The widget also checks, but only cosmetically — a request from a domain you did not list is refused regardless of what the page claims about itself. Without this, anyone could point your paid message quota at their own traffic.

How long does setup take?

Adding your website as a source starts a crawl; the bot can answer as soon as the first pages are indexed. How long that takes depends on how many pages your plan allows — see plans and limits.

What does it load in the visitor's browser?

One bundle, roughly 10 kB gzipped, rendered inside a Shadow DOM. It does not inherit or leak your site's CSS, so it cannot break your layout and your stylesheet cannot break it.

Will it work on a JavaScript-rendered site?

The widget will. The crawler may not: it reads the HTML the server returns, so a site that renders its content in the browser gives it an empty shell. Grounly detects this and reports it on the source instead of silently indexing nothing — but the content is not obtained. See sources.