Quick Start

Add Converd to any page by loading one asynchronous script with your site identifier. If you are logged in, the snippet below fills in automatically; otherwise replace YOUR_SITE_ID with the value from your dashboard after you sign in (your user id is used as the site identifier in the snippet).

Before you paste anything

Sign in to the Converd dashboard and open the embed instructions (same script format as this page). If you use multiple brands or organizations, the snippet can include an optional organization id—copy the tag from the dashboard so both attributes match your setup.

You need permission to edit your site’s HTML, theme, tag manager, or framework layout. If someone else deploys production, send them this section and the generated snippet.

Step 1 — Copy the script

The live snippet uses your account when you are signed in. Guests see a template with YOUR_SITE_ID as a placeholder.

<script
  src="https://converd.vercel.app/widget.js"
  data-converd-site-id="YOUR_SITE_ID"
  async
></script>

Static example (placeholder ID) for documentation:

<script
  src="https://converd.vercel.app/widget.js"
  data-converd-site-id="YOUR_SITE_ID"
  async
></script>

Step 2 — Place it on each page

Paste the snippet once per HTML document, ideally immediately before the closing </body> tag. That load order keeps your content and layout scripts ahead of the widget bootstrap while still allowing the agent to attach to the page reliably.

In a shared layout (for example a Next.js root layout or a WordPress theme footer), add the script in one place so every route inherits it. For single-page applications, ensure the shell that wraps authenticated and marketing views both include the embed if those surfaces should offer chat.

Minimal HTML example

Your page structure might look like this (script shown with the placeholder ID):

<!doctype html>
<html lang="en">
  <head>
    <title>Your site</title>
  </head>
  <body>
    <!-- your content -->
<script
  src="https://converd.vercel.app/widget.js"
  data-converd-site-id="YOUR_SITE_ID"
  async
></script>
  </body>
</html>

Step 3 — Verify it works

  • Reload the page in a private window to avoid cache.
  • Confirm the launcher or widget appears in the corner you configured.
  • Send a short test message and check that replies reference your knowledge, not unrelated content.
  • If nothing renders, double-check the site ID, ad blockers, and that the script URL is reachable from your domain.