Installation guide

Install ZettyChat in minutes

Add ZettyChat to your website with one script tag, connect it to your workspace with a public site key, and start talking to visitors from the floating widget.

What is ZettyChat?

A lightweight website widget connected to your live chat workspace.

ZettyChat loads from a single script tag, uses your public site key to identify the right workspace, and opens a floating chat launcher so visitors can start conversations from any approved page.

Reads your site key

The widget reads the data-site-key from the script tag to connect the visitor to the correct workspace.

Mounts a floating launcher

When the script loads, it injects the chat launcher and panel into the page so visitors can open it from the bottom corner.

Remembers the visitor session

Conversation state is stored in the browser so visitors can keep chatting across page loads without starting over.

Save approved domains

In your live chat settings, add the exact hostnames where the widget is allowed to run, such as example.com or www.example.com. The widget checks approved domains when it connects.

Copy your chat script

Copy the install snippet from your dashboard and replace YOUR_SITE_KEY with your public site key if you are working from a template.

Script

<script async src="https://www.zetty.co.uk/widget.js" data-site-key="YOUR_SITE_KEY"></script>

Paste it into your HTML before the closing body tag

Place the script near the end of the page body. That is the safest install point because the current widget mounts itself into document.body as soon as it loads.

HTML

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Your website</title>
  </head>
  <body>
    <!-- Your content here -->
    <script async src="https://www.zetty.co.uk/widget.js" data-site-key="YOUR_SITE_KEY"></script>
  </body>
</html>

Tip: If your platform only offers a single global custom-code field, use the site-wide footer or body-injection slot rather than the head when possible.

Save, publish, and test the widget

After publishing your changes, open the site in a fresh tab. You should see the launcher appear in the bottom-right corner and be able to start a conversation.

Quick checks

Save at least one approved domain in your dashboard before testing.

Use your real public site key in the script tag.

Place the script before the closing body tag so the widget can mount safely.

Publish the page and hard refresh after installing.

If it still does not appear, check blockers or script optimizers on the site.

Need help?

Still not showing?

If the widget is not appearing after install, the most common causes are an incorrect site key, missing approved domains, or aggressive script blocking on the site.

Contact support Open dashboard

Widget settings

What you can configure before installing.

The dashboard already exposes the core widget controls you need for setup: widget name, title, brand colour, allowed domains, and the install snippet that is tied to your site key.

Title

The header title shown at the top of the widget. Default: Chat with us.

Greeting

The first line visitors see before they start a conversation. Default: Hi. How can we help?

Brand colour

Controls the launcher and highlighted widget accents so the experience matches your site branding.

Allowed domains

Locks the widget to the hostnames you approve so your script cannot be reused on the wrong site.

FAQ

Common install questions.

Where do I get my site key?

Your public site key comes from the live chat settings area in the dashboard. Each company widget is separated by that key.

Can I install the widget across multiple pages?

Yes. Place the same script in your global site template so it loads anywhere you want the launcher to appear, as long as the host is approved.

What can I customise before publishing?

You can configure the widget title, greeting, brand colour, allowed domains, and the install snippet from the dashboard settings.

Troubleshooting

Widget not showing?

Run through these checks before you assume the script is broken. Most install issues are configuration mismatches rather than code failures.

Confirm the installed host matches one of your approved domains.

Check the script uses data-site-key and not an empty placeholder.

Make sure the widget script URL points at your live app domain.

Republish the site and hard refresh the page after editing templates.

Disable any optimizer that moves or strips third-party scripts.

Open the browser console and look for a missing data-site-key warning.