Docs — Install RAGSell on your website

Overview

What gets installed

One async script tag drops a tiny widget on your site. The widget talks to RAGSell's API, which answers visitor questions using your own content — and captures qualified leads into your dashboard.

~11 KB gzipped

Smaller than most analytics scripts. Async load — never blocks your page.

Domain-locked

Each install is scoped to your domain via origin allowlist + secret token.

Framework-agnostic

Works on any site — HTML, Next.js, WordPress, Shopify, Webflow, anything.

Quick start

Live in 3 steps

The fastest path from sign-up to a working concierge on your site.

1
Sign up + tell us your site URL
Create an account, drop your site URL into the onboarding form, and we'll crawl your content and extract a starting knowledge base.
Start free trial
2
Review + confirm your knowledge base
Open the customer dashboard's Knowledge base tab, fix anything the auto-extract got wrong, add a few FAQs, and click Confirm. The agent now treats your profile as authoritative.
3
Paste one script tag
Copy the snippet below, replacing the demo data-site with your real one from the dashboard. Reload your site — the chat button appears within ~1 second.
snippet
 <script async src="https://cdn.ragsell.io/v1/widget.js" data-site="dnt_test_001" ></script>

Install methods

Pick your stack

The widget is just a script tag — the only thing that changes between platforms is where you paste it.

Grab your site_key

In the customer dashboard at /knowledge, the site_key appears in the top-right. It looks like dnt_test_001.

Paste the snippet before `</body>`

Swap dnt_test_001 for your real site_key.

snippet

<!-- Paste this just before </body> on every page -->
<script
  async
  src="https://cdn.ragsell.io/v1/widget.js"
  data-site="dnt_test_001"
></script>

Minimal full-page example

example.html

<!doctype html>
<html>
  <head><title>My site</title></head>
  <body>
    <h1>Welcome</h1>

    <!-- RAGSell widget -->
    <!-- Paste this just before </body> on every page -->
    <script
      async
      src="https://cdn.ragsell.io/v1/widget.js"
      data-site="dnt_test_001"
    ></script>
  </body>
</html>

Verify

Reload the page. A teal floating chat button should appear bottom-right within ~1 second. Send a test message and confirm the agent responds with content from your site.

Security & data

How your data is handled

The widget is designed to be the safest thing you can drop on a customer-facing site.

Origin allowlist

Each site_key is locked to one or more domains. Requests from anywhere else get rejected.

Scoped DOM + styles

Widget renders inside its own tree with namespaced CSS — it can't touch your page's styles, and your page can't leak into the widget.

Anonymous by default

We store a random visitor_id cookie for conversation continuity. No fingerprinting, no PII unless the visitor types it into the lead form.

CSP-friendly

Add cdn.ragsell.io to script-src and api.ragsell.io to connect-src. Detailed examples available on request.

Customize

Make it look like your brand

The widget reads its branding from your dashboard — no code changes needed.

Accent color

Any hex code. Affects the launcher and message bubbles.

Greeting message

First thing visitors see when they open the chat panel.

Widget position

Bottom-right (default), bottom-left, or custom offset.

Persona override

Replace the default friendly concierge persona with your own system prompt (advanced).

Allowed domains

Restrict where the widget will mount. Production sites should always list explicit domains.

FAQ

Frequently asked

Does the widget slow down my site?⌄

No. The script loads with async, so the browser never waits for it. The bundle is ~11 KB gzipped — smaller than most analytics scripts and below most performance budgets.

Will it conflict with my existing CSS or JavaScript?⌄

No. The widget renders inside its own scoped DOM tree with namespaced styles. Your styles can't leak in, and the widget can't touch yours.

What if my site uses a Content Security Policy (CSP)?⌄

Add cdn.ragsell.io to your script-src and api.ragsell.io to connect-src. If you need a policy example for your specific framework, email us.

Where is visitor data stored?⌄

Anonymous visitor_id in browser localStorage so a returning visitor reuses the same conversation thread. Conversations and any lead data captured live in our database, in your dedicated tenant. You can export everything as CSV at any time.

Can I disable lead capture?⌄

Yes — toggle it off in the dashboard. The agent will still answer questions but won't ask for contact info.

Can I self-host the widget bundle?⌄

The widget code is closed-source on Phase A. Enterprise plans on Phase B can request a self-hosted or white-label widget bundle — contact us.

Support

We'll install it for you

If anything in this guide trips you up, send us a message — we'll get the widget live on your site for free.

Email support

hello@ragsell.io — we usually reply within a few hours.

Try it free for 14 days

No credit card. See your AI concierge live on your site in minutes.

Install RAGSell in under 5 minutes.