# Setting up affiliates

Category: [Marketing](https://basecomp.io/help/marketing)
Updated: 2026-11-20

> Switch on the affiliate programme in Settings > Affiliates, then add or approve affiliates who earn commission on sales through their ?ref= link.

Affiliates are partners, such as influencers or community pages, who promote your store with their own referral link and earn a commission on the sales it brings in. You switch the programme on in [Settings > Affiliates](https://basecomp.io/dashboard/go/settings/affiliates) and manage affiliates under [Marketing > Affiliates](https://basecomp.io/dashboard/go/marketing/affiliates).

Don't see **Affiliates** in your sidebar? Add the **Affiliates** app from [Apps](https://basecomp.io/dashboard/go/apps). See [Adding and removing apps](https://basecomp.io/help/getting-started/adding-and-removing-apps).

### Switching the programme on

Go to **Settings > Affiliates** and turn on **Enable affiliate program**. Then set:

- **Require approval**: when on, people who apply through your website wait as **Pending** until you approve them. When off, they are approved straight away.

- **Extra information on your sign-up page**: up to 2,000 characters shown on your public affiliate page, for anything the settings cannot say (for example negotiable rates or who to contact).

- **Commission settings**: the **Default commission rate** (a percentage, 0 to 100), the **Commission hold period** (0 to 365 days) and **Repeat order attribution**. These are covered in [Affiliate commissions and payouts](https://basecomp.io/help/marketing/affiliate-commissions-and-payouts).

- **Referral discount**: turn on **Give affiliates a discount for their referrals** to give each affiliate their own coupon when they are approved, set by **Discount percentage**, **Minimum spend** and **First order only**. Changing these affects coupons created from then on; codes already issued keep their terms.

Click **Save**.

[Image: Affiliate settings with the Enable affiliate program and Require approval switches and the box for extra sign-up page text]

### How affiliates join

**They apply on your website.** Once the programme is on, your store has a public affiliate page at /affiliates. It explains how it works using your real settings (the commission percentage, and the discount their audience gets if you offer one) and has an **Apply Now** form asking for name, email, website, how they will promote you and any notes. With approval required they are emailed to say the application was received.

**You add them yourself.** Go to **Marketing > Affiliates**, open the list and click **Create Affiliate**. Fill in their details and, optionally, a **Referral code** (leave it empty to generate one).

### Approving an affiliate

Open a pending affiliate, change **Status** to **Active** and click **Save**. This approves them and emails them their referral link. Changing a pending affiliate to **Rejected** emails them to say the application was not approved. You can also select several in the list and use **Approve** or **Suspend**.

Only a change from pending sends an email. Suspending an affiliate sends nothing, and a suspended affiliate stops earning.

### The referral link

Each affiliate's link is your store address with ?ref=CODE added, shown as **Referral URL** on their record with a copy button. When a visitor arrives through it:

- their visit is credited to that affiliate;

- if the affiliate has a **Discount coupon**, a bar at the top of your site tells the visitor what they get (for example "25% off your first order of £20 or more. No code needed, it comes off at checkout."), and it is applied to their basket automatically at checkout (the visitor can remove it). The bar only shows while the coupon is valid, so a coupon with a future start date shows nothing until that date. If the basket is under the coupon's minimum spend, checkout says how much more to spend (unless the coupon only covers some competitions).

A referral link only earns commission on customers it brings in. An existing customer who happens to click someone else's link does not earn that affiliate anything.

### Per-affiliate settings

On each affiliate's record you can override the store defaults: a **Custom commission rate** (entered in basis points, where 100 = 1% and 1000 = 10%; the form shows the percentage as you type), a **Maximum commission per order**, a **Custom hold period** and a **Custom attribution window**. Under **Referral discount** you can pick an existing coupon, or turn on **Create a new coupon for this affiliate** to generate a percentage coupon whose code is their referral code.

### Sale notifications for the affiliate

Some affiliates, especially prize comparison sites, keep their own sales tracking and ask to be told about each sale. Affiliates can set this up themselves under **Sale notifications** in their portal, or you can do it for them on the affiliate's record under **Sale notifications**. Both places show and change the same settings, so you always see what an affiliate has set. Either of you can set either or both of:

- **Webhook URL**: an HTTPS address of theirs. For every sale through their link we send it a JSON message (event affiliate.conversion ) with the order number, each competition and its ticket count, the amount paid, the time and the commission, and a second one ( affiliate.reversal ) if the order is later refunded. Failed deliveries are retried, and the address is paused after repeated failures until you click **Resume**.

- **Email**: an address we email for every sale and refund through their link, with the same details.

Once a webhook URL is saved, the record shows its **Signing secret**. Give it to the affiliate: every message carries an X-Webhook-Signature header signed with it, so they can check it came from you. **Send test** sends them a sample message, and **Rotate secret** replaces the secret if it leaks.

If the affiliate adds their own click ID to their link, for example ?ref=CODE&click_id=abc123 (clickid, subid and sub_id work too), that ID is sent back with each sale so they can match it to their click.

No customer details are ever sent: no names, email addresses or postal addresses.

### The affiliate portal

Affiliates sign in at /affiliates/login with a login link sent to their email. Their portal shows their referral link, their discount code if they have one, their sale notification settings, clicks, conversions, conversion rate, total earned, pending, approved and paid amounts, recent commissions and payout history.

### See also

- [Affiliate commissions and payouts](https://basecomp.io/help/marketing/affiliate-commissions-and-payouts)

- [Using coupon codes](https://basecomp.io/help/marketing/using-coupon-codes)

- [Refer a friend](https://basecomp.io/help/marketing/refer-a-friend)

- [Team roles and permissions](https://basecomp.io/help/settings/team-roles-and-permissions)
