Browse docs

Guides

Developers

Installing the widget

Where to paste the snippet, how the loader works and how to confirm it is firing.

The NudgeVisor widget is a single, lightweight snippet. Once it is on a page, that page is monitored live and recorded for replay — no further setup required.

Get your snippet

In the dashboard, open the site you want to track. Its install snippet is shown at the top of the page with a one-click copy button. The snippet already has your site's public key baked in, so you do not need to fill anything in.

Paste it before </head>

Paste the snippet just before the closing </head> tag on every page you want to track. If your site uses a shared layout, header or template, add it there once and it will cover the whole site.

<script>
(function(w,d,k){
  w.NudgeVisor=w.NudgeVisor||{q:[]};
  ['identify','setAttributes','on'].forEach(function(m){
    w.NudgeVisor[m]=w.NudgeVisor[m]||function(){w.NudgeVisor.q.push([m,[].slice.call(arguments)])};
  });
  w.NudgeVisor.publicKey=k;
  var s=d.createElement('script');s.async=1;
  s.src='https://app.nudgevisor.com/widget/v1.js';
  s.setAttribute('data-nv-key',k);
  d.head.appendChild(s);
})(window,document,'YOUR_PUBLIC_KEY');
</script>

Loading it from the <head> means the widget starts capturing from the very first moment of the page, so you never miss the start of a session.

How the loader works

The snippet is a tiny loader stub. It defines NudgeVisor.identify, setAttributes and on immediately, then loads the full widget asynchronously so it never blocks your page. Any calls you make before the widget finishes loading are queued and replayed once it is ready — so it is always safe to call identify() right after the snippet. For the full mechanics, see The install snippet.

Confirm it is firing

  1. Open your site in a new browser tab.
  2. Switch to the NudgeVisor live visitor view.
  3. You should appear within a couple of seconds, showing your current page, location and device.

If nothing shows up, check that the snippet is present in the page source (view source and search for NudgeVisor), that you used the right site's public key, and that an ad-blocker is not blocking the script.

Single-page apps

The widget automatically tracks client-side navigation, so React, Vue, Livewire and other SPA frameworks work out of the box — each route change is recorded as a new page view in the visitor's journey without a full page reload.

Next steps