Installing tracking on your site

Voris collects data through a single <script> tag that you paste into your website’s <head>. This page explains how to add it, what to do for common platforms, and how to confirm it is working.

What the script looks like

When you create a site, the wizard gives you a snippet that looks like this:


<script defer data-site-id="your-site-id" src="https://cdn.voris.ai/v1/vor.js"></script>

A few notes:

The hostname (cdn.voris.ai in the example) may differ on your deployment. Always use the exact snippet the wizard shows you.
The data-site-id attribute identifies your site. Do not share this with others if you want to keep your tracking private.
The defer attribute means the script loads without blocking your page. You are safe to place it in the <head>.

You can re-copy this snippet any time from Site settings under the Script tag section.

Tracking script in site settings Tracking script in site settings

Where to paste it

The rule is: paste the snippet into your site’s HTML so it appears inside the <head> section, ideally right before the closing </head> tag.


<html>
  <head>
    <!-- other tags ... -->
    <script defer data-site-id="your-site-id" src="https://cdn.voris.ai/v1/vor.js"></script>
  </head>
  <body>
    <!-- your content -->
  </body>
</html>

Placing it in <body> will usually still work, but you may miss early events and it is not recommended.

Platform-specific notes

Every platform has its own way of letting you edit the <head>. Here are the usual spots for the most common ones. If your platform is not listed, search your platform’s documentation for “custom head code” or “add tracking script.”

Shopify

In your admin, go to Online Store then Themes, click Edit code on your current theme, and open layout/theme.liquid. Paste the snippet just before </head>.

WordPress

The simplest path is a plugin like Insert Headers and Footers (or the native Custom HTML block in some themes). Paste the snippet into the header/head section and save. If you are comfortable editing theme files, paste it into header.php before </head>.

Webflow

Go to your Project Settings, open the Custom Code tab, and paste the snippet into the Head Code field. Save and publish.

Framer

Open your project, go to Site Settings, find the General section, and paste the snippet into the Custom Code — Start of <head> tag field. Publish the site.

Plain HTML / static sites

Open the file that contains your <head> (often index.html or a shared layout partial). Paste the snippet before the closing </head> tag. Re-deploy.

Next.js / React / other frameworks

If you are working with a developer or your site runs on a code framework, ask them to add the snippet to the HTML head. Most frameworks have a recommended way to do this (for example, the <Head> component in Next.js). The developer docs cover this in more detail.

Verify it is working

The quickest way to confirm the script is live:

Open your site in a new incognito window.
Load any page.
Go back to the Voris site wizard, or to your site’s dashboard.
If you are still on the wizard, it auto-advances within a few seconds of receiving the first event.
If you have already finished the wizard, look at the live indicator at the top of your dashboard — a green dot with an event count means data is flowing.

Live indicator Live indicator

If you do not see data after a few minutes, see Troubleshooting.

Domain verification (optional)

Voris offers an optional domain verification step. It is not required for tracking to work, but it unlocks additional features in later phases.

Copy the verification meta tag from Site settings. It looks like:
```
<meta name="voris-verify" content="your-site-id">
```
Paste it inside your site’s <head> (right next to the tracking script is fine).
Publish your site.
Go to Site settings and click the Verify button.

Once verified, the site is flagged as yours in our records. No visible change happens on your dashboard today; this matters for upcoming features.

Removing the script

If you ever want to stop tracking, delete the <script> tag from your site and re-deploy. You can also soft-delete the site in Voris — see Site settings.