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

# Reward rules

> What referrers and friends earn — reward types, conditions, priority, and approval.

Reward rules define who earns what. There are two roles:

* **Referrer** (advocate) — earns a reward for each successful referral
* **Friend** — the person who was referred; earns a reward on their
  purchase

Manage rules under **Referral → Program → Reward Setup**. Click **Create
reward**, choose who gets it, and configure.

## Reward types

| Type                | Example                                  |
| ------------------- | ---------------------------------------- |
| Percentage Discount | 10% discount code for each referral sale |
| Fixed Discount      | \$10 discount code                       |
| Free Shipping       | Free shipping coupon                     |
| Free Product        | A product you choose, given as a gift    |

Each rule has a **Title** (e.g. "Give 10% off"), a **Status** (Active /
Draft), a **Value**, and optionally a coupon **prefix-based code**,
validity period, minimum requirements (purchase amount or quantity), and
discount **Combinations**.

## Conditions (optional)

Conditions control when the reward is earned. Combine them with **Match
All** or **Match Any**:

**Based on referrer parameters** — Number of referrals · Referral sales
amount by the referrer · Usage limit per referrer (how many times one
referrer can earn this reward)

**Based on referred person parameters** — First order (recommended for
friend rewards) · Email domain of the referred person · Each referral
order value should be… · Each referral order should have selected
products / variants

Operators include Greater Than (or Equal), Less Than (or Equal), Is any
of / Is none of, and Contains any/all / Does not contain for products.

<Tip>
  Keep **Reward only the customer's first order** checked on friend
  rewards. It's the single most effective anti-abuse setting — repeat
  customers can't farm new-customer discounts through referral links.
</Tip>

## Priority

With multiple active rules per role, **Manage priority** (drag to
reorder, then **Update order**) decides which rule wins when several
match.

## Approval mode

Under **Referral → Settings → Reward Approval**, choose how referrer
rewards are issued:

* **Auto** — automatically rewards the referrer
* **Manual** — you approve each reward yourself (under Referrer Rewards)
* **Auto approve after delay** — auto-approves after X days (1–80),
  useful to outlast your refund window

<Tip>
  Set the delay just past your return window (e.g. 30 days). Refunded
  orders then never produce paid-out rewards — no clawbacks needed.
</Tip>

## Use cases & examples

<AccordionGroup>
  <Accordion title="Classic double-sided reward" icon="gift" description="Friend: 10% off first order. Referrer: $10 coupon per sale.">
    Two rules: a Friend reward (Percentage Discount, 10, first-order
    condition) and a Referrer reward (Fixed Discount, 10). The default
    onboarding setup — works for most stores.
  </Accordion>

  <Accordion title="Milestone reward for super-referrers" icon="medal" description="An extra $50 coupon at 5 successful referrals.">
    Add a second Referrer rule with condition **Number of referrals →
    Greater Than or Equal to → 5**, and set its priority above the base
    rule. Champions get recognized automatically.
  </Accordion>

  <Accordion title="High-value referrals only" icon="gem" description="Reward only when the friend's order is $75+.">
    On the referrer rule, add **Each referral order value should be →
    Greater Than or Equal to → 75**. Small orders don't trigger
    payouts; your economics stay safe.
  </Accordion>

  <Accordion title="Free product instead of discounts" icon="box-open" description="A gift product feels bigger than its cost.">
    Choose **Free Product** and pick a low-cost, high-perceived-value
    item. Gifts are memorable and don't train customers to wait for
    discounts.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="A reward wasn't issued after a referral sale">
    Check, in order: the rule is **Active**; the sale actually came
    through the referral link or coupon (see **Sales & Analytics**);
    all rule conditions pass (first-order, order value, products);
    approval mode isn't **Manual** with the reward waiting in Referrer
    Rewards; and the customer isn't blocked by fraud protection.
  </Accordion>

  <Accordion title="The wrong rule applied">
    Rules are evaluated by priority — open **Manage priority** and make
    sure the more specific rule sits above the general one.
  </Accordion>

  <Accordion title="I can't delete a rule">
    Rules that already issued rewards can't be deleted — the app offers
    **Disable** instead, which keeps history intact while stopping new
    rewards.
  </Accordion>
</AccordionGroup>

## Need help?

<CardGroup cols={3}>
  <Card title="Book a call" icon="calendar-days" href="https://cal.com/yukoteam/shopjar">
    Schedule a free call with our team for personal setup assistance.
  </Card>

  <Card title="Contact support" icon="comments" href="#crisp-chat">
    Chat with us directly — we're happy to help with any question.
  </Card>

  <Card title="Install Shopjar" icon="download" href="https://apps.shopify.com/referral-and-affiliates">
    Get [Shopjar Referral & Affiliate Marketing](https://apps.shopify.com/referral-and-affiliates) from the Shopify App Store.
  </Card>
</CardGroup>