> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rivvi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the web chat widget

> Add the Rivvi web-chat concierge to your website — by platform, in a few minutes.

The Rivvi web-chat concierge is one script, keyed to your organization. Rivvi
picks the best install path for your site automatically (WordPress plugin, Google
Tag Manager, a platform guide, or the raw snippet) on the **Web chat → Install**
tab in your dashboard. This page documents every path.

<Note>
  The script is **placement-agnostic** — it waits for the page body before it
  mounts, so it works in the footer, before the closing `</body>` tag, or through a
  tag manager. It does **not** need to go in `<head>`.
</Note>

## WordPress (recommended for WordPress sites)

The Rivvi WordPress plugin installs the widget with a single code — no snippet
editing, and it automatically works around caching/optimizer plugins.

<Steps>
  <Step title="Generate an install code">
    In Rivvi, open your web-chat program → **Install** and click **Generate install
    code**. Codes are single-use and expire after 60 minutes.
  </Step>

  <Step title="Install the plugin">
    Download the Rivvi Web Chat plugin from the Install tab and add it to WordPress
    (Plugins → Add New → Upload Plugin), then activate it.
  </Step>

  <Step title="Pair the site">
    In WordPress, go to **Settings → Rivvi Web Chat**, paste your install code, and
    click **Connect**. That's it — the widget goes live and Rivvi confirms the install
    automatically.
  </Step>
</Steps>

The plugin registers exclusions for Cloudflare Rocket Loader, WP Rocket,
Autoptimize, LiteSpeed Cache, and W3 Total Cache so the widget isn't deferred or
broken by performance optimizers. It's multisite-aware (pair each site with its
own code) and removes all stored settings on uninstall.

## Google Tag Manager

<Steps>
  <Step title="Add a Custom HTML tag">
    In GTM, create a new tag → **Custom HTML**, and paste the embed snippet from your
    Install tab.
  </Step>

  <Step title="Fire on All Pages">
    Set the trigger to **All Pages** so the widget loads site-wide.
  </Step>

  <Step title="Publish">
    Submit and publish the container. The widget appears on the next page load.
  </Step>
</Steps>

You can also import the [Rivvi GTM template](/web-chat/gtm-template) for a
guided tag with the org id and API host as fields.

## Squarespace

Settings → **Advanced → Code Injection → Footer**. Paste the snippet and save.

## Wix

Settings → **Custom Code → + Add Custom Code**. Paste the snippet, set it to load
on **All pages** and in the **Body - end** position.

## Webflow

Project Settings → **Custom Code → Footer Code**. Paste the snippet and publish.

## Duda

Site → **Third-party Code** (or the footer HTML block for your plan). Paste the
snippet and republish.

## Any site (raw snippet)

Paste the one-line snippet from your Install tab anywhere the script can run —
before the closing `</body>` tag, in the site footer, or via a tag manager.

## Confirming the install

Rivvi verifies the install automatically: once the widget loads on an allowed
site, the Install tab shows **Live**. If it shows **Detected on an unapproved
site**, add that site to your allowed origins to activate it. See
[allowed sites & security](/web-chat/security) for how origins work.

If your site enforces a Content Security Policy, see the
[CSP requirements](/web-chat/csp).
