Skip to main content
Dub Partners require a Business plan subscription or higher.
Dub Partners lets you build powerful, scalable referral and affiliate programs with 1-click global payouts and white-labeling functionality.

​
Step 1: Install the @dub/analytics client-side SDK

First, install the @dub/analytics client-side SDK. This script captures click attribution by storing a first-party cookie that links conversions back to the referring partner.
For a detailed explanation of the click→cookie→lead→sale flow, see How attribution works.
The SDK also supports: You can install the @dub/analytics script in several different ways:

React

Manual installation

Framer

Shopify

WordPress

Webflow

Google Tag Manager

You can verify the installation with the following tests:
  1. Open the browser console and type in _dubAnalytics – if the script is installed correctly, you should see the _dubAnalytics object in the console.
  2. Add the ?dub_id=test query parameter to your website URL and make sure that the dub_id cookie is being set in your browser.
If both of these checks pass, the script is installed correctly. Otherwise, please make sure:
  • The analytics script was added to the <head> section of the page
  • If you’re using a content delivery network (CDN), make sure to purge any cached content
Once the script is installed, make sure to verify that client-side click tracking is working as expected by checking if the following is true:
  1. There is a successful /track/click request in your browser’s Network tab (and no errors in the Console tab).
  2. The dub_id cookie is being set upon a successful /track/click request.
  3. The click tracked correctly in the Events tab of your Dub workspace.
In case you missed it, you’ll also need to allowlist your site’s domain to ensure the client-side click events are ingested by Dub. Navigate to your workspace’s Analytics settings page and add your site’s domain to the Allowed Hostnames list.

Open analytics settings

Generate your publishable key, allowlist domains, and configure conversion tracking in your Dub dashboard
Enabling conversion tracking for a workspace
When testing things out locally, you can add localhost to the Allowed Hostnames list temporarily. This will allow local events to be ingested by Dub. Don’t forget to remove it once you’re ready to go live!

​
Alternative: Use a native integration

Instead of the manual server-side SDK setup in Step 2, you can use one of our native integrations to track conversions automatically:

Stripe

Automatically track purchases, subscriptions, and refunds

Shopify

Native app for e-commerce conversion tracking
If you use Stripe or Shopify, you can skip Step 2 and proceed directly to Step 3: Set up your partner program.

​
Step 2: Install the Dub server-side SDK + track conversion events

If you are using Stripe or Shopify, you can skip this step since our native integrations will automatically track conversions for you. Read the Stripe or Shopify integration guide for more information.
The recommended way to track conversions on Dub is using server-side tracking, which is more reliable than client-side tracking. Depending on which framework you’re using, you can use our native SDKs:

TypeScript

TypeScript library for the Dub API

Go

Go library for the Dub API

Python

Python library for the Dub API

Ruby

Ruby library for the Dub API

PHP

PHP library for the Dub API
If you’re using a framework that isn’t listed, you can use the Dub REST API to track events on the server-side: Once you install the SDKs, you can start tracking conversion events.

​
Tracking lead events

The first event you’ll want to track is a lead event. This happens when a user performs an action that indicates interest in your product or service. This could be anything from:
  • Signing up for an account
  • Adding a product to cart
  • Joining a mailing list
A diagram showing how lead events are tracked in the conversion funnel
Depending on which platform you’re using, we offer native integrations for the following:

Google Tag Manager

No-code tracking via GTM tags

Segment

Route leads through your Segment pipeline

HubSpot

Sync leads directly to HubSpot contacts
Our most common lead event is Sign Up, which happens when a user signs up for an account. Depending on which authentication framework you’re using, here are a few examples of how to send Sign Up lead events:

Clerk

Better Auth

NextAuth.js

Supabase

Auth0

Appwrite

The lead event will serve as the source of truth for the customer’s identity and which link they came from. This means that all subsequent actions performed by the customer (e.g. upgrading their plan, purchasing a product) will automatically be attributed to the original link. To learn more about tracking lead events with Dub, refer to the following resources:

Tracking lead events

Read the full guide on tracking lead events with Dub

POST /track/lead endpoint

View the full list of attributes you can pass when sending a lead event

​
Tracking sale events

The second event you’ll want to send is a sale event. This happens when a user purchases your product or service. This could be anything from:
  • Subscribing to a paid plan
  • Usage expansion (upgrading from one plan to another)
  • Purchasing a product
A diagram showing how sale events are tracked in the conversion funnel
Depending on which payment processor you’re using, we offer native integrations for the following:

Stripe

Shopify

Alternatively, you can also send sale events manually using our SDKs or the POST /track/sale API endpoint. To learn more about tracking sale events with Dub, refer to the following resources:

Tracking sale events

Read the full guide on tracking sale events with Dub

POST /track/sale endpoint

View the full list of attributes you can pass when sending a sale event

​
Step 3: Set up your partner program

Once you have conversion tracking up and running, you can follow these steps to set up your partner program:

Create your partner program

Launch the program onboarding wizard to set up your affiliate or referral program
  1. Go through the program onboarding flow to create your program.
    • If you’re migrating from another platform, you can also import your partners and historical conversions (e.g. from Rewardful).
  2. Connect your bank account for partner payouts.
  3. Invite your partners to join your program + set up a branded program landing page for future partners.
  4. Create custom reward rules and dual-sided incentives to incentivize partners to share your link with others.
  5. Set up a whitelabeled referral dashboard that lives directly inside your app so your users can automatically enroll in your partner program without leaving your app.
For a comprehensive guide on program configuration including conversion tracking integration, see Partner program setup.
Dub Partners

​
Verify your setup

Before going live, confirm you’ve completed each step:
StepVerification
1. Script installedCheck that @dub/analytics loads on your site (no console errors)
2. Domain allowlistedYour domain is in Allowed Hostnames
3. Cookie workingVisit your site via a Dub link and check for dub_id cookie
4. Conversions trackingTest a signup/purchase and verify it appears in your Analytics dashboard
5. Program createdPartner program exists in your dashboard
6. Payouts readyBank account connected in payout settings

​
Next steps

How attribution works

Deep dive into click→lead→sale attribution

Program setup guide

Configure rewards, invitations, and white-labeling