Skip to main content
Sauna Scale
Start
All docs

Embed the Sauna Scale chat widget

Paste one script tag in your site footer. The widget loads asynchronously, doesn't block your page, and works on every CMS — WordPress, Squarespace, Webflow, custom HTML, anything that lets you drop in raw HTML.

The snippet

<script src="https://saunascale.com/widget.js" data-org="your-org-slug" async></script>

Replace your-org-slug with the slug of your Sauna Scale organization. You can find it in Settings → Branding or in the URL of your dashboard.

Where to paste it

Put the snippet just before the closing </body> tag on every page where you want the chat bubble to appear. Most installers add it site-wide so the widget shows up on the home page, the services page, and any blog posts.

WordPress

Use a header/footer plugin (e.g. Insert Headers and Footers) and add the snippet to the footer. Save. The bubble appears across the site.

Squarespace

Settings → Advanced → Code Injection → Footer. Paste the snippet. Save.

Webflow

Project Settings → Custom Code → Footer Code. Paste the snippet. Publish.

Custom HTML / static sites

Add the snippet to your site template just before </body>.

Configuration options

The widget accepts a few data-* attributes:

  • data-org (required) — your Sauna Scale org slug.
  • data-position — bottom-right (default) or bottom-left.
  • data-attention-text — optional callout text that pops above the bubble after a delay (e.g. "Get an instant quote").
  • data-attention-delay — milliseconds before the callout appears (default 4000).

Example with options:

<script
  src="https://saunascale.com/widget.js"
  data-org="your-org-slug"
  data-position="bottom-right"
  data-attention-text="Get an instant quote"
  data-attention-delay="6000"
  async
></script>

Programmatic control

The loader exposes window.SaunaScaleWidget with three methods:

  • window.SaunaScaleWidget.open() — open the chat panel.
  • window.SaunaScaleWidget.close() — close it.
  • window.SaunaScaleWidget.toggle() — toggle.

Wire your own CTA button to it:

<button onclick="window.SaunaScaleWidget.open()">Talk to us</button>

Troubleshooting

The bubble doesn't appear. Check the browser console for errors. The most common causes are a typo in data-org (the slug must exist and the org must be active), the script loading too early (move it to the end of </body>), or a Content Security Policy (CSP) that blocks saunascale.com. Add script-src and frame-src allowances for the Sauna Scale domain.

The bubble appears but the chat panel is empty. Your CSP is likely blocking the iframe. Add frame-src https://saunascale.com (or the domain you've configured) to your CSP.

I want the widget on some pages but not others. Only include the script tag on the pages where you want the bubble. Skip it on checkout pages, internal portals, etc.

Multiple Sauna Scale orgs on one site. Use one snippet per page. The widget is keyed off data-org, so two orgs on the same page would conflict — pick one per page.

Verifying it works

  1. Load a page with the snippet on it.
  2. The chat bubble appears in the bottom-right.
  3. Click it. The panel expands.
  4. Send a test message. It lands in your Inbox in the Sauna Scale dashboard within a few seconds.

That's it. Once a homeowner chats, the agent qualifies them, the lead lands in your pipeline, and you can quote them from the dashboard.