14-Day Free Trial
Help center

Install the chat widget on your website

The Jiviq chat widget is one small <script> tag. If you can paste a line of code into your website, you can install it — no plugin, no build step, no developer required for a standard site.

It works on any website that lets you add a script tag: hand-written HTML, WordPress, and most site builders with a “custom code” or “embed code” option.

Before you start

  • You need to be signed in to the admin app at app.jiviq.com.
  • Viewing the widget settings is open to everyone on your team, but changing them (including adding your website’s domain) needs an owner or admin role. See Add your team for roles.
  • You need edit access to your website — enough to paste code before the closing </body> tag.

Where the code lives

In the admin app, open Settings → Chatbox Widget (on newer accounts the sidebar entry is named Chat Studio). The page walks you through four steps:

  1. Choose capability — pick which Workspace the chat connects to. If you only have one, it’s already selected.
  2. Customize launcher — the chat button’s position, color, and icon. You can change all of this later; see Customize the chat widget.
  3. Where will this appear? — the list of websites allowed to show your chat. This step is required (more below).
  4. Copy the code — your personal embed snippet, with a Copy code button.

On Chat Studio, everything is still there: the code and the website list live on its Install tab, under “Website code” and “Websites that can show your chat”.

Step 3 matters: add your website’s domain

The widget only works on websites you’ve listed. Without your domain on the list, visitors won’t be able to load the chat — the admin page warns you and disables the Copy button until at least one domain is added.

Type your bare domain — yourbusiness.com, without https:// or any path — and press Add. (If you paste a full address, the page asks you to remove the scheme and path.) A few things to know:

  • We verify the domain exists (a public DNS check). If it’s rejected, the page shows a “Why?” button with the reason.
  • Local and private addresses are rejected — you can’t allow-list localhost. Test on your live site instead.
  • Wildcards work for subdomains: *.yourbusiness.com covers every subdomain in one entry.
  • The limit is 200 domains per account. Most accounts use one or two.
  • Each verified domain gets a Test link that opens a test page so you can see the widget running before you touch your own site.

Paste the code

Click Copy code in step 4. Your snippet looks like this — with your own values already filled in:

<script
  src="https://widget.jiviq.com/v1.js"
  data-tenant="your-business"
  data-capability="your-workspace-id"
  data-launcher-color="#000666"
  data-position="bottom-right"
  data-icon="chat"
  async defer>
</script>

Always copy it from the admin rather than retyping it — the data-tenant and data-capability values are specific to your account, and a typo means the widget silently won’t load.

Paste it right before the closing </body> tag, on every page where you want the chat to appear. The script loads asynchronously (async defer), so it doesn’t block your page from rendering.

That’s the whole install. Once it’s pasted, you never need to touch it again — appearance and behavior changes you make in the admin reach the widget automatically.

WordPress

  1. Open Appearance → Theme File Editor.
  2. Select footer.php.
  3. Paste the snippet right before the </body> tag.
  4. Click Update File.

If your theme doesn’t allow direct editing, install the free WPCode plugin (formerly Insert Headers and Footers) and paste the snippet into its Footer field.

Other site builders

Any builder that lets you add custom HTML or a script tag to your pages will work — look for a setting named something like “custom code”, “code injection”, or an “Embed” block, and paste the snippet there. If your builder only allows code on one page, the chat will only appear on that page.

If your site sends a Content-Security-Policy

Most sites don’t set a CSP, and if yours doesn’t you can skip this section. If it does, a CSP that omits the widget’s origin blocks it silently — the chat simply never appears. Add these directives:

script-src  https://widget.jiviq.com
frame-src   https://widget.jiviq.com
connect-src https://widget.jiviq.com

connect-src is the one people miss, and missing it fails partially and silently: the chat still opens, but the button keeps its pasted defaults instead of your saved settings. The admin’s Copy-code step has a “My site has a strict CSP” section with a copy button for these.

Check it worked

Reload your website. The chat button should appear in the corner you chose (bottom-right unless you changed it). Click it — the chat panel opens and you can send yourself a test message, which shows up in your team’s admin app.

If nothing appears:

  • Is your website’s domain on the list in step 3? This is the most common cause.
  • Is the snippet actually on the page? View your page source and search for widget.jiviq.com.
  • Did your site builder publish the change? Some builders need an explicit publish step after editing code.
  • Does your site set a CSP? See the section above.

Visitors who are already logged in to your app

By default the chat asks visitors who they are. If your website is an app where people log in, you can pass their name and email to the widget with one line of JavaScript — or go further and give returning customers their conversation history without them proving who they are each time. Both tiers are covered in the Widget Identity integration guide.

Next steps