> ## Documentation Index
> Fetch the complete documentation index at: https://doc.trackrev.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from Rewardful

> Move your Rewardful affiliates, link tokens, coupon codes, and unpaid balances to TrackRev.

Rewardful identifies an affiliate's link by its **token** — the `?via=` value. Import it and your
affiliates keep the same code on TrackRev.

## Export your affiliates

<Steps>
  <Step title="Open Affiliates">
    In Rewardful, open the campaign you're moving and go to its **Affiliates** list.
  </Step>

  <Step title="Export as CSV">
    Use the export action to download the list.
  </Step>

  <Step title="Keep the token column">
    The token is what makes `?via=` links portable — don't strip it from the file.
  </Step>
</Steps>

## Import it

In TrackRev, go to **Settings → Migration**, pick **Rewardful**, and upload the file:

| Rewardful column                   | TrackRev field                                |
| ---------------------------------- | --------------------------------------------- |
| `email`                            | Email — the affiliate's identity              |
| `first_name` + `last_name`         | Name                                          |
| `token`                            | Tracking parameter → their referral link slug |
| `coupon`                           | Coupon code                                   |
| `state`                            | Approval status                               |
| `paypal_email`                     | PayPal email                                  |
| `visitors`, `leads`, `conversions` | Opening clicks / leads / sales                |
| unpaid earnings / balance          | Carried-over balance                          |

If your export splits names across two columns, both are mapped and joined. If it has one `name`
column instead, that's mapped directly.

## Keeping `?via=` links working

A Rewardful link is `https://yourapp.com/?via=sarah`. With **Keep their existing referral codes**
on, the token `sarah` becomes the slug of the affiliate's TrackRev link, so the code an affiliate
has printed in their newsletter, video description, or blog post is still theirs.

Where a token can't be reused — it's already taken in your workspace, or it isn't a valid link
slug — that affiliate imports with a freshly generated link and the results screen lists exactly
which ones changed, so you can tell them.

## Commission terms

Rewardful's per-affiliate overrides don't come across as rules; TrackRev models bands rather than
per-person rates. Recreate them as [groups](/affiliate/commissions) before importing and select
the group in the import step — every affiliate in the file joins it, and changing the band's terms
later updates all of them at once.

## What doesn't transfer

* Referral and commission history — reconcile and pay out in Rewardful before cutting over.
* Stripe coupon objects — the codes are imported as attribution codes; the coupons themselves
  still live in [your Stripe account](/affiliate/commissions).
* Affiliate tax forms and payout details beyond the PayPal email.

<Card title="Back to the migration overview" icon="arrow-left" href="/affiliate/migration/overview">
  The full before/after checklist for moving a programme.
</Card>