# TrackRev

> Track any link, attribute every sale to the channel that earned it, and run an affiliate programme — one platform, one definition of a sale.

- [Welcome to TrackRev](https://doc.trackrev.io/introduction.md): Run your SaaS affiliate programme on real link attribution — commissions reconciled to real charges, on one data model and one definition of a sale.
- [Quickstart](https://doc.trackrev.io/getting-started/quickstart.md): From sign-up to your first tracked, attributed click in about five minutes: create a workspace, make a link, install the pixel and connect revenue.
- [Core concepts](https://doc.trackrev.io/getting-started/core-concepts.md): The handful of ideas the rest of the documentation is built on — workspaces, links, channels, visitors, events, orders and attribution.
- [The onboarding wizard](https://doc.trackrev.io/getting-started/onboarding.md): A walkthrough of the guided setup you see when you first create a workspace — and the dashboard checklist that resumes it.
- [Install the tracking pixel](https://doc.trackrev.io/getting-started/install-pixel.md): Add one script tag to your site so TrackRev can tie browser sessions to clicks and join them to revenue.
- [Links & Analytics overview](https://doc.trackrev.io/link-tracking/overview.md): Branded short links on your own domain with first-party, server-side click tracking that survives Safari ITP and iOS — and joins every click to the revenue it produced.
- [Create tracking links](https://doc.trackrev.io/link-tracking/create-links.md): Mint a branded short link for every channel in one step, with UTMs baked in, an AI-suggested slug, and optional device targeting, expiration and password protection.
- [Channels](https://doc.trackrev.io/link-tracking/channels.md): The acquisition sources TrackRev rolls every click and sale up into — so you can rank what actually pays.
- [Campaigns & folders](https://doc.trackrev.io/link-tracking/campaigns.md): Group tracking links into campaigns, one destination plus its per-channel links, and group campaigns into date-ranged folders for cleaner launch reporting.
- [Custom tracking domains](https://doc.trackrev.io/link-tracking/custom-domains.md): Serve your short links and affiliate signup page from your own branded domain, like go.yourbrand.com, with automatic TLS. It takes one DNS record.
- [Bulk import links](https://doc.trackrev.io/link-tracking/bulk-import.md): Create hundreds of tracking links at once by uploading a CSV, one per influencer, placement or store. TrackRev builds them all in seconds.
- [QR codes](https://doc.trackrev.io/link-tracking/qr-codes.md): Turn any tracking link into a branded QR code with custom colours, gradients, logos and frames. Scans are tracked like clicks, with geo, device and attribution.
- [Expiration, passwords & deep links](https://doc.trackrev.io/link-tracking/advanced-links.md): Expire links by date or clicks, password-protect them, and route mobile and desktop to different destinations.
- [Link analytics](https://doc.trackrev.io/link-tracking/analytics.md): Clicks, unique visitors, geo, device, browser and OS breakdowns — with bots filtered out automatically.
- [Link retargeting](https://doc.trackrev.io/link-tracking/retargeting.md): Build retargeting audiences from any link — even links to sites you don't own — with no consent prompt.
- [Revenue Attribution overview](https://doc.trackrev.io/revenue-attribution/overview.md): Rank every acquisition channel by the revenue and retained MRR it produces — not by clicks. A first-party attribution platform for SaaS.
- [Connect Stripe](https://doc.trackrev.io/revenue-attribution/connect-stripe.md): Pull your Stripe charges with a read-only restricted key and attribute every sale to the channel that earned it.
- [Connect Paddle, Polar, Lemon Squeezy & more](https://doc.trackrev.io/revenue-attribution/connect-processors.md): Connect Paddle, Polar, Lemon Squeezy, Creem or Dodo Payments with a read-only key — instant webhook sync plus an hourly pull backstop.
- [Pass the visitor id to checkout](https://doc.trackrev.io/revenue-attribution/pass-vid-to-checkout.md): The one line that joins a purchase back to the exact click that produced it — for every payment processor.
- [Attribution models](https://doc.trackrev.io/revenue-attribution/attribution-models.md): Choose how credit is assigned across a visitor's journey — last-touch, first-touch or linear — and switch any time without re-tagging.
- [Attribution windows](https://doc.trackrev.io/revenue-attribution/attribution-windows.md): Set how far back TrackRev looks from a sale when assigning credit. Clicks older than the attribution window earn none, so match it to your buying cycle.
- [Channels & lifetime value](https://doc.trackrev.io/revenue-attribution/channels-and-ltv.md): Rank every channel by the revenue it produced and by all-time lifetime value, subscription renewals included, rather than by clicks, over 7, 30 or 90 days.
- [Visitors & the journey](https://doc.trackrev.io/revenue-attribution/visitors.md): Follow any visitor from their first anonymous click to paying customer. The Visitors page shows each person's demographics and step-by-step journey.
- [Orders](https://doc.trackrev.io/revenue-attribution/orders.md): Orders are the real charges TrackRev pulls from your payment processor, joined to the visitor who bought: one definition of a sale for reports and commissions.
- [Refunds & renewals](https://doc.trackrev.io/revenue-attribution/refunds-and-renewals.md): How TrackRev handles refunds, chargebacks, partial refunds and subscription renewals so revenue and commissions stay honest.
- [Exports](https://doc.trackrev.io/revenue-attribution/exports.md): Export channel performance for any date range as a CSV of clicks, visitors, conversions and revenue, or pull the same data with the TrackRev API.
- [Affiliate & Partners overview](https://doc.trackrev.io/affiliate/overview.md): Run a full affiliate and partner programme reconciled to real charges — recurring commissions, a white-label portal, multi-tier networks and automated payouts.
- [Create an affiliate programme](https://doc.trackrev.io/affiliate/create-program.md): Create an affiliate programme: set the commission structure, publish a branded signup page and partner portal, and run cash and credit programmes side by side.
- [Migrate from another platform](https://doc.trackrev.io/affiliate/migration/overview.md): Import your affiliates, their referral codes, coupon codes, and unpaid balances from FirstPromoter, Rewardful, Tolt, and other affiliate platforms.
- [Migrate from FirstPromoter](https://doc.trackrev.io/affiliate/migration/firstpromoter.md): Move your FirstPromoter promoters, ref IDs (the ?fpr= value), promo codes and unpaid balances to TrackRev from a CSV, so promoters keep their codes.
- [Migrate from Rewardful](https://doc.trackrev.io/affiliate/migration/rewardful.md): Move your Rewardful affiliates, link tokens (the ?via= value), coupon codes and unpaid balances to TrackRev, so every affiliate keeps the same code.
- [Migrate from Tolt](https://doc.trackrev.io/affiliate/migration/tolt.md): Move your Tolt affiliates, referral links, coupon codes and unpaid balances to TrackRev from a CSV. Referral codes are pulled out of Tolt links for you.
- [Migrate from any other platform](https://doc.trackrev.io/affiliate/migration/other-platforms.md): Import affiliates from Tapfiliate, Dub, LeadDyno, Refersion, Partnero, Trackdesk, Reditus, UpPromote, GrowSurf — or any CSV at all.
- [Assisted migration](https://doc.trackrev.io/affiliate/migration/assisted.md): For PartnerStack, Impact, ShareASale/Awin, Post Affiliate Pro, and Everflow — send us what you have and we'll map and load it.
- [Commission structures](https://doc.trackrev.io/affiliate/commissions.md): Percentage vs flat, one-time vs recurring, per-partner coupons, caps, and how the commission ledger works.
- [Recruit & approve partners](https://doc.trackrev.io/affiliate/recruiting.md): Grow your affiliate programme: share your public signup link, invite partners directly, and choose whether applications are auto-approved or reviewed.
- [The partner portal & branding](https://doc.trackrev.io/affiliate/partner-portal.md): White-label your signup page and partner portal under your logo, colours, subdomain or custom domain.
- [Multi-tier & network commissions](https://doc.trackrev.io/affiliate/multi-tier.md): Pay partners on the sales of the partners they recruit, with a pool that can never mathematically overpay.
- [Payouts](https://doc.trackrev.io/affiliate/payouts.md): See exactly what each partner is owed, batch payouts, export PayPal or Wise CSVs, settle through any payment method, then mark partners paid in TrackRev.
- [Tax forms](https://doc.trackrev.io/affiliate/tax-forms.md): Collect W-9 and W-8 tax forms from partners in the partner portal before you pay them, see each partner's status in your dashboard and download the forms.
- [Fraud detection](https://doc.trackrev.io/affiliate/fraud-detection.md): How TrackRev catches self-referral abuse in credit programmes, and the commission controls for cash programmes.
- [Credit rewards & fulfilment](https://doc.trackrev.io/affiliate/credits-and-fulfilment.md): Reward partners and referred customers with product credit delivered straight into your own backend — no cash payout.
- [Referral credits with MongoDB](https://doc.trackrev.io/affiliate/referral-credits-mongodb.md): End-to-end setup for a product-credit referral programme when your users live in MongoDB — connect the collection, then enroll and report signups through the API.
- [Messaging & email kits](https://doc.trackrev.io/affiliate/messaging-and-email-kits.md): Chat one-to-one with your partners and give them ready-made email templates that carry their own tracking link.
- [Product-led referrals (the widget)](https://doc.trackrev.io/affiliate/referral-widget.md): Run product-led referrals: turn every signed-in user into a referrer with TrackRev's in-app widget and referral API, and reward both sides with credit.
- [Embeddable Refer & Earn dashboard](https://doc.trackrev.io/affiliate/dashboard-embed.md): Give every user a full referral dashboard inside your product — link, clicks, signups, purchases, conversion rate and rewards.
- [For affiliates: using your portal](https://doc.trackrev.io/partner-portal/for-affiliates.md): A guide for partners — how to join a programme, find your referral links, track earnings and get paid.
- [Link-in-bio pages](https://doc.trackrev.io/tools/link-in-bio.md): Build a hosted link-in-bio page for your social profiles in minutes. It's free to publish, every link on it is tracked, and it can run on your own domain.
- [QR code generator](https://doc.trackrev.io/tools/qr-generator.md): A free, no-signup QR code designer with custom colours, logos and frames. Codes run in your browser, never expire, carry no watermark and export as PNG or SVG.
- [UTM builder](https://doc.trackrev.io/tools/utm-builder.md): Build correctly formatted UTM links with the free TrackRev UTM builder and its source and medium cheat-sheet. It runs in your browser and stores nothing.
- [Workspaces](https://doc.trackrev.io/account/workspaces.md): A workspace is one brand or product in TrackRev. See what it scopes, from links and clicks to events and visitors, how to switch, and when you need another.
- [Team & roles](https://doc.trackrev.io/account/team-and-roles.md): Invite teammates into a TrackRev workspace so everyone can see what's working, and give each person a role that controls what they can change.
- [Branding & white-label](https://doc.trackrev.io/account/branding.md): White-label the pages your partners and visitors see: put your logo, colour and domain on the affiliate signup page, partner portal and link-in-bio pages.
- [Plans & billing](https://doc.trackrev.io/account/plans-and-billing.md): What each TrackRev plan includes, how the workspace and commission limits work, and how to upgrade, downgrade or cancel. Paid plans unlock the whole product.
- [Security & privacy](https://doc.trackrev.io/account/security.md): How TrackRev handles your data — first-party by design, read-only payment access, and a GDPR-ready architecture.
- [Set up Stripe attribution end to end](https://doc.trackrev.io/guides/stripe-attribution-end-to-end.md): A complete walkthrough — from your first tracking link to a Stripe sale credited to the right channel.
- [Launch an affiliate programme in a day](https://doc.trackrev.io/guides/launch-an-affiliate-program.md): Launch a live, branded affiliate programme in a day with this practical checklist, from connecting revenue and branding your pages to your first partners.
- [Track a single-page app](https://doc.trackrev.io/guides/track-a-single-page-app.md): Record pageviews on client-side route changes in React, Vue or any single-page app: load the TrackRev pixel once and fire a pageview on each navigation.
- [Migrate from Rewardful (or FirstPromoter, Tolt, Tapfiliate)](https://doc.trackrev.io/guides/migrate-from-rewardful.md): Move an affiliate programme from Rewardful, FirstPromoter, Tolt or Tapfiliate to TrackRev: recreate your terms, import partners and repoint your signup link.
- [API introduction](https://doc.trackrev.io/developers/introduction.md): A REST API to read your channels, links, clicks and visitor journeys, and to drive referral programmes — plus signed webhooks for events.
- [Authentication](https://doc.trackrev.io/developers/authentication.md): Create secret and publishable TrackRev API keys in Settings → Developers and send them as Bearer tokens. Every key is scoped to one workspace.
- [Command line (CLI)](https://doc.trackrev.io/developers/cli.md): npm install -g trackrev — channels, links, the raw click stream and any visitor's journey from your terminal. Tables when you read, TSV when you pipe, JSON for jq.
- [MCP server](https://doc.trackrev.io/developers/mcp.md): trackrev-mcp — TrackRev as Model Context Protocol tools. 61 tools over stdio, generated from the same command registry as the CLI, so Claude, Cursor or any MCP client can run your program.
- [Errors](https://doc.trackrev.io/developers/errors.md): How the TrackRev API reports errors: the consistent JSON error envelope every failed request returns, and what each HTTP status code means.
- [Date ranges & pagination](https://doc.trackrev.io/developers/rate-limits-and-pagination.md): How TrackRev API analytics endpoints take a time window, either the last N days or an explicit from/to range, and how to page through large result sets.
- [Me](https://doc.trackrev.io/developers/endpoints/me.md): Which workspace a key belongs to, its plan and limits, the key itself, and which API features this deployment supports.
- [Channels API](https://doc.trackrev.io/developers/endpoints/channels.md): Channel performance — clicks, visitors, conversions and revenue — ranked by revenue, with optional lifetime value.
- [Links](https://doc.trackrev.io/developers/endpoints/links.md): Create tracking links, read them back, and get per-link performance — clicks, visitors, conversions and revenue.
- [Clicks](https://doc.trackrev.io/developers/endpoints/clicks.md): GET /api/v1/clicks returns your workspace's raw click stream, newest first and cursor-paginated, authenticated with your secret API key.
- [Visitor journey](https://doc.trackrev.io/developers/endpoints/visitor-journey.md): Get the full chronological journey for one visitor from the TrackRev API: every click, identify call and order, oldest first, from first touch to purchase.
- [Credits](https://doc.trackrev.io/developers/endpoints/credits.md): Credit endpoints for non-cash reward programmes: list the credit grants and balances partners and referees have earned, and mark a grant delivered.
- [Referrals](https://doc.trackrev.io/developers/endpoints/referrals.md): Enroll a user as a referrer, report referred signups and read their referral stats — the API behind product-led referral programmes.
- [Partner workspaces](https://doc.trackrev.io/developers/endpoints/partner-workspaces.md): For platforms that run TrackRev on behalf of their own customers: provision one workspace per customer and get a key for it.
- [Webhooks](https://doc.trackrev.io/developers/webhooks.md): Receive a signed JSON POST at your endpoint in real time when a click, lead, sale, referral or commission happens. Subscribe only to the events you need.
- [Referral widget](https://doc.trackrev.io/developers/referral-widget.md): Embed TrackRev's in-app referral widget to enroll signed-in users as referrers and show them their referral link and share UI, without building your own.
- [Dashboard embed](https://doc.trackrev.io/developers/dashboard-embed.md): Embed a full Refer & Earn dashboard in your app — referral link, clicks, signups, purchases, conversion rate and rewards.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.