Install

Install on plain HTML

One script tag in the head. Works on any site you can edit HTML on.

This is the basic install. Every other platform guide is a variation on this one. If your platform isn't documented yet, you can almost always apply this method by finding where your site renders its <head>.

1. Copy your script tag

Head to your site's settings in the Seena dashboard. You'll find a snippet that looks like:

<script
  src="https://app.seenalabs.io/widget/seena.js"
  data-site-id="YOUR_SITE_ID"
  async
></script>

The data-site-id is generated per site. Never hardcode a different one — that's how you'd accidentally route data to the wrong place.

2. Paste it into your <head>

Open the HTML file(s) that render every page of your site — usually a <head> partial, template, or layout. Paste the script just before the closing </head> tag:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>My Site</title>
    <!-- other head contents -->

    <script
      src="https://app.seenalabs.io/widget/seena.js"
      data-site-id="YOUR_SITE_ID"
      async
    ></script>
  </head>
  <body>
    <!-- ... -->
  </body>
</html>

The async attribute is intentional — it tells the browser to load Seena without blocking the rest of your page. We recommend keeping it.

3. Confirm the dot is live

Open your site in a new window. Then, go back to the Seena dashboard and the state of your site should be flipped from waiting to live.

Stuck in "waiting"?

  • Check the browser console. Errors loading seena.js usually mean a wrong data-site-id or a Content Security Policy (CSP) blocking app.seenalabs.io.
  • Check your CSP. If you send a Content-Security-Policy header, allow script-src 'self' https://app.seenalabs.io and connect-src 'self' https://app.seenalabs.io.
  • Check for ad blockers. Some aggressive privacy extensions block the script. Try a clean profile.

4. See your first session

After you exit your website, i.e., complete your session. Head to the "Analytics" page and a row should appear within a minute of the visit.

A note on caching

If your site is behind a CDN, changes to your head HTML may be cached for a few minutes. If the data isn't flowing after 5 minutes, clear your CDN cache for HTML responses.

What to do next