Help Center · Boxli Insight Tag

The Insight Tag: landing-page attention in 30 seconds.

Drop one line of HTML on the landing page each QR code points at. The Boxli Insight Tag records how long every recipient stays — and rolls it into the Total Attention metric on each send.

The snippet

Paste this anywhere inside the <head> of your landing page (or just before </body>):

One line — that’s the whole install
<script async src="https://app.sendaboxli.com/dwell.js"></script>
The script is tiny (~1 KB), loads asynchronously, and stays silent on visits that did not come from a Boxli QR redirect — no impact on organic traffic or page speed.

Install on your platform

Webflow

  1. Open your project → Project Settings → Custom Code.
  2. Paste the snippet into the "Head Code" box.
  3. Save → Publish.

Platform docs →

Framer

  1. Open Site Settings → General → Custom Code.
  2. Paste the snippet into the "Start of head tag" section.
  3. Click Publish.

Wix

  1. Editor → Settings → Custom Code.
  2. Click + Add Custom Code → paste the snippet.
  3. Set "Place Code In" to Head and "Apply to" to All pages → Apply.

Squarespace

  1. Settings → Advanced → Code Injection.
  2. Paste the snippet into the Header box.
  3. Save.

WordPress

  1. Install a header-snippet plugin (e.g. WPCode or Insert Headers & Footers).
  2. Open its settings → Header section.
  3. Paste the snippet → save.

Carrd

  1. Site Settings (gear icon) → Embed.
  2. Click + → Code → paste the snippet.
  3. Set Type = head → save → publish.

Custom HTML

  1. Open your landing page template.
  2. Paste the snippet inside the <head> tag (or just before </body>).
  3. Deploy.

See it live in the dashboard

Settings → Domains in your Boxli dashboard lists every domain the Insight Tag has reported from, with connection status and a test button — the quickest way to confirm an install without opening DevTools.

Verify it's working

1
Open your page in test mode
Visit your landing page with ?bx_qr=test appended to the URL so the tag activates — organic visits without that parameter stay silent.
2
Watch the console
Open DevTools → Console. You should see lines tagged [boxli/dwell]:
[boxli/dwell] Tracking active. qr=test send= endpoint=https://app.sendaboxli.com/api/track/dwell
[boxli/dwell] → start 0s
[boxli/dwell] → heartbeat 5s
3
Nothing logged?
The script never loaded — re-check the snippet is on the page (View source → search for dwell.js). Seeing "tracking inactive" instead? The snippet is installed but the visit didn't arrive via a Boxli QR redirect — expected behaviour for organic traffic.

What gets tracked

  • Start — fired the moment the page loads with a Boxli QR param.
  • Heartbeats — fired every 5 seconds while the tab is visible. Backgrounded tabs do not count toward dwell.
  • End — fired on tab close or navigation. Best-effort; heartbeats are the authoritative dwell record.
  • Each session shows up on the corresponding send's detail page under the Landing page (web) analytics tab (see Visit history) and rolls into Total Attention.

When you can't install the snippet

Some destinations are out of your control — Calendly, LinkedIn profiles, vendor checkout pages, etc. Browsers do not let any tool measure time spent on a page it does not own, so dwell is not measurable for those scans. You still get every other signal: scan event, scan timestamp, recipient device, click-through to the destination, and video brochure watch time from inside the box.

Third-party CTA workaround
If you want to measure attention on a third-party CTA, point the QR at a short landing page you own (with the tag installed) that has a single button forwarding to the third-party URL.

Privacy

The Insight Tag only fires when the URL carries a Boxli QR identifier. It records dwell duration, device user agent, and IP address; it does not set cookies, does not read browser history, and does not run on any visit unrelated to a Boxli send.

Stuck?

We'll install it for you.

Send us your landing page URL and we'll paste the snippet for you on a screenshare — under five minutes.

Email us