Skip to main content
The Whop pixel is a lightweight JavaScript snippet you add to your website. It measures page views, links visitors to their purchases, and attributes conversions back to your ads — using Whop’s first-party payment data instead of third-party cookies. Once installed, everything shows up live in your pixel dashboard.
You only need your company ID (biz_xxxxxxxxxxxxx) to install the pixel. Find it in the URL of your dashboard, or on the pixel page at https://whop.com/dashboard/{biz_id}/pixel.

​
Install the snippet

Paste this snippet inside the <head> of every page in your funnel — landing pages, advertorials, checkouts, and thank-you pages, not just your homepage. Replace biz_xxxxxxxxxxxxx with your own company ID.
Pixel snippet
<script>
!function(w,d,s,u,n,a,b){if(w[n])return;a=w[n]={q:[],t:+new Date,s:[],o:u,track:function(){a.q.push([+new Date].concat([].slice.call(arguments)))},setScope:function(){a.s=[].slice.call(arguments).filter(function(x){return typeof x==="string"});a.q.push([+new Date,"setScope"].concat(a.s))},scope:function(){var c=[].slice.call(arguments);return{track:function(){a.q.push([+new Date].concat([].slice.call(arguments)).concat([{__scope:c}]))}}}};b=d.createElement(s);b.async=1;b.src=u+"/s.js";d.getElementsByTagName(s)[0].parentNode.insertBefore(b,d.getElementsByTagName(s)[0])}(window,document,"script","https://t.whop.tw","whop");
whop.setScope("biz_xxxxxxxxxxxxx");
whop.track("page");
</script>
If your platform (Shopify, Webflow, Framer, WordPress, etc.) has a dedicated field for custom header or <head> code, paste the snippet there so it ships on every page template automatically.
For most brands — especially ecommerce stores that send traffic to Whop checkout — this snippet is all you need. Whop automatically tracks page views, checkout views, purchases, subscriptions, and trials. You only need extra event code if you want to track steps Whop cannot see, like a lead form on your own site.

​
Verify the install

Open https://whop.com/dashboard/{biz_id}/pixel and watch Step 1 — Install the pixel. Page views appear within about a minute of the first visit, and the status turns green once data is flowing. Domains the pixel reports from are listed there too.

​
Track events

Most brands can skip this section. Add extra whop.track calls only when your funnel has an important step outside Whop checkout — for example a lead form, call booking, application, or quiz. The most common setup is to fire whop.track("lead") either:
  • when the lead form submits successfully
  • on the thank-you page or confirmation page the visitor sees after submitting
Standard events
whop.track("lead");                                      // a standard event
whop.track("schedule", { value: 50, currency: "USD" });  // optionally with a value
whop.track("custom", { name: "quiz_completed" });        // or your own event name

​
Standard event names

Use these names for common funnel moments. Each one optionally accepts a value (number) and currency (ISO 4217 code).
EventWhen to fire it
leadA visitor submits contact info or an opt-in form
scheduleA call or appointment is booked
submit_applicationAn application is submitted
contactA visitor starts a conversation or contact request
complete_registrationA signup or registration finishes
view_contentA key page or piece of content is viewed
add_to_cartAn item is added to a cart
customAnything else — pass { name: "your_event" }
For custom events, put your event name in data.name. Keep names short, stable, and reuse a small set — custom names are capped at 250 characters.
Custom event
whop.track("custom", { name: "watched_vsl" });

​
Attach customer fields

You usually do not need to attach extra customer fields. Whop can often match events from the pixel, checkout activity, browser signals, and first-party payment data automatically. If you already have customer details available when an event fires, you can attach them for extra matching coverage. It does not hurt to include them, and it can improve matching. These fields can be attached to any event type, and you can send only the fields you have.
Lead with customer fields
whop.track("lead", {
  email: "visitor@example.com",
  first_name: "Jane",
  last_name: "Doe",
  name: "Jane Doe",
  phone: "+15551234567",
  external_id: "customer_123",
  city: "New York",
  state: "NY",
  postal_code: "10001",
  country: "US",
});
FieldDescription
emailVisitor’s email address
first_nameVisitor’s first name
last_nameVisitor’s last name
nameVisitor’s full display name
phoneVisitor’s phone number
external_idYour own user/customer ID
cityVisitor’s city
stateVisitor’s state or region
postal_codeVisitor’s postal or ZIP code
countryVisitor’s country
Don’t track purchases, subscriptions, or trials. Whop records every checkout view, purchase, subscription, and trial start server-side with zero configuration, and the pixel will not accept duplicates. Only send the events Whop cannot see, like leads or bookings on your own infrastructure.

​
Send events from your server

If you want to send events from your backend instead of (or in addition to) the browser — ad blockers can’t touch server-side events, and they’re more reliable for high-value conversions — use the Conversions API. Attach as much customer information as you have so the event attributes correctly.

Conversions API reference

Create conversion events from your server with an API key. Full endpoint, fields, and examples.

​
Advanced: multiple companies on one page

Most brands can ignore this. It only applies if the same website or landing page is intentionally tracking events for more than one Whop business. In that case, set a default scope with multiple IDs, or scope an individual call.
Scoping
// Default scope for every subsequent event
whop.setScope("biz_companyA", "biz_companyB");
whop.track("lead");

// Or scope a single call
whop.scope("biz_companyA").track("lead");

​
Next steps

Conversions API

Send conversions from your server when browser tracking is not enough — ad blockers cannot touch them.

Whop Ads & WHIXEL

How first-party attribution powers ad measurement and lookalike audiences.

Tracking integrations

Pipe Whop sales data into Meta, Google, Hyros, and other platforms.

Tracking links

Build branded links to attribute traffic and conversions across channels.