Skip to main content

Installing

Install on Framer

Site settings → Custom code → Start of head tag, then publish.

Steps

  1. Open your project and go to Site settings.

  2. Open Custom code.

  3. Paste the tag into Start of <head> tag.

  4. Publish.

<script
  defer
  data-website-id="ts_a1b2c3d4e5f6"
  data-domain="example.com"
  src="https://truestat.io/js/t.js"
></script>

Copy it from your site's install page in the app, with your key already substituted.

One chip covers Webflow, Framer and Squarespace — the tag and the place it goes are the same.

Publish, then check

Like Webflow, Framer applies custom code to the published site, not to the editor preview. Testing in the canvas or in Framer's preview mode will show nothing. Publish, then load the live URL.

Framer navigations

Framer sites navigate client-side between pages. The script handles that — it records a view on each path change with no extra configuration.

Custom events on Framer elements

Framer does not expose arbitrary HTML attributes on every element, so the attribute route is not always available. The JavaScript route always is. In a code component or an overlay:

window.truestat("signup");

Or with parameters:

window.truestat("initiate_checkout", {
  plan: "growth",
  price: 39,
});

See Tracking custom events for the naming rules — they are enforced, and an event that breaks them is dropped rather than corrected.

Verify

Publish, load the live site, and check the install page in the app. It flips to Recording visits within seconds.

AI crawlers

Not possible on Framer. Counting GPTBot and ClaudeBot needs code running on the server that answers the request, and Framer gives you nowhere to put it — a limit of the hosting, not of this install.

Move the site behind your own server or a CDN worker and Server-side tracking applies.

Was this page helpful?

Last updated September 17, 2026