Hey Thula

Install the widget on your site

One snippet, on every page you want the widget.

By HeyThula · Updated

The widget is a single script tag. It loads asynchronously, so it never delays your page.

Step 1 — Copy your snippet

Go to Settings → Install. The snippet under Install snippet already contains your workspace ID, so copy it from there rather than from documentation.

The Install tab in Settings, showing the install snippet with the workspace ID already filled in, and a Copy button

Step 2 — Paste it into your site

Paste it just before the closing </body> tag, on every page you want the widget to appear on. Most sites have a shared layout, footer or template — putting it there covers the whole site at once.

<!-- Heythula support widget -->
<script>
(function(w,d,s){var j=d.createElement(s);j.async=true;j.src='https://cdn.heythula.com/widget.js';
j.onload=function(){w.Support.init({workspaceId:'w_xxxxxxxxxx'})};
d.head.appendChild(j)})(window,document,'script');
</script>

Step 3 — Check it appears

Load your site and look for the launcher in the bottom-right corner. Send yourself a test message; it should arrive in your inbox within a second or two.

If you're signed in to your own product while testing, consider also setting up identifying logged-in users — otherwise your test arrives as an anonymous visitor.

Your workspace ID is safe to publish

The w_… value sits in your page source, where anyone can read it. That's fine and expected — it identifies which workspace a message belongs to and grants nothing.

What must never appear in page source is your identity secret. That's a different value, used server-side only.

If the widget doesn't appear

Check the snippet is on the page you're looking at. Adding it to a homepage template doesn't cover pages rendered from a different layout.

Check for script blockers. Ad and tracker blockers sometimes catch chat widgets. Try a private window with extensions disabled.

Check your content security policy. If your site sets a CSP, it needs to allow scripts from cdn.heythula.com.

Give it a moment. The script is deliberately asynchronous, so the launcher appears shortly after the rest of the page rather than blocking it.

Was this helpful?