Skip to main content
Free3 minutesBeginner

Using the Zenovay Browser Extension

Install the Chrome or Firefox extension to verify that your Zenovay tracking script is working and watch live events as they fire.

browser-extensionchromefirefoxverificationdebugging
Last updated:

The Zenovay Analytics Inspector is a free browser extension for Chrome and Firefox that detects the Zenovay tracking script on any page. It's the fastest way to confirm your install is working — no DevTools, no dashboard polling, just a coloured badge on every site you visit.

What you'll see

When the extension is installed, a small icon appears in your browser toolbar. The badge on top of it tells you the state of the current tab:

BadgeMeaning
(empty)No Zenovay tracking script detected on this page
Amber !Script detected, but no events fired yet
Green ONScript detected and actively firing events
Blue CScript detected, cookieless mode

Click the badge to open the popup, which shows your tracking code, script source URL, cookieless status, and a live list of events being captured.

Install

Chrome Web Store

Coming soon — we'll update this article with a direct install link once the extension is approved.

Firefox Add-ons

Coming soon — same story for Firefox.

Developer install (right now)

If you can't wait for the store listings, you can load the extension directly:

  1. Visit github.com/zenovay/extension-zenovay/releases
  2. Download the latest extension-zenovay-v*.zip
  3. Unzip it to a folder
  4. In Chrome: open chrome://extensions, turn on Developer mode (top-right), click Load unpacked, pick the unzipped folder
  5. In Firefox: open about:debugging#/runtime/this-firefox, click Load Temporary Add-on, pick manifest.json inside the unzipped folder

How to verify your install

  1. Add the Zenovay tracking script to your website (see Installing the Tracking Script)
  2. Open your site in Chrome or Firefox with the extension installed
  3. Look at the extension badge in your toolbar

If you see ON (green), your install is working — the script is loaded and firing events.

If you see ! (amber), the script is loaded but isn't yet emitting visible events. This usually means production mode is on (no debug). The events are still being recorded by Zenovay — you just can't see them in the popup. To see them, either:

  • Add data-debug="true" to your script tag temporarily, or
  • Enable Beta: deep inspection in the popup (it monkey-patches the network calls to show what's being sent)

If you see an empty badge, the script isn't being detected at all. Common causes:

  • The script tag wasn't actually added to the page (check page source for data-tracking-code="...", or the legacy data-id="...")
  • A Content Security Policy is blocking the script from loading
  • The script src is wrong or the file isn't reachable

Live events

Click the badge to open the popup and see live events as they fire. You'll see things like:

  • pageview — page load
  • click:cta — clicks on buttons or links
  • heartbeat — periodic "user is still active" pings
  • scroll — scroll milestones
  • identify — when zenovay.identify() is called
  • goal:signup — custom goal completions
  • revenue — purchases tracked via zenovay.revenue()

The popup keeps the last 50 events per tab, with newest at the top.

Privacy

The extension doesn't send any data to Zenovay or anywhere else. Everything it captures stays local in your browser's session storage and is cleared when you close the browser. It also doesn't track which sites you visit; it only detects whether each page has a Zenovay tracker installed, when you're on that page.

For the full privacy posture, see the docs page.

Uninstall

In Chrome: chrome://extensions → find "Zenovay Analytics Inspector" → click Remove.

In Firefox: about:addons → click the gear next to "Zenovay Analytics Inspector" → Remove.

There's nothing left behind — the extension doesn't write to your filesystem or sync to any cloud account.

Got stuck?

If the extension doesn't detect a tracker that you're sure is installed, verify your installation the old-fashioned way through the dashboard. If that confirms the script IS working, please file an issue at github.com/zenovay/extension-zenovay/issues with the site URL — we'll add it as a test fixture.

Was this article helpful?