Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yuko.so/llms.txt

Use this file to discover all available pages before exploring further.

Where to find this: Shopify admin → Apps → Yuko Loyalty → Referral → Program Setup

​
Introduction

This is the single page where you configure the entire referral program — rewards on both sides, where customers land, what channels they share through, and how Yuko stops fraud.

​
What problem this solves

Most referral programs require stitching together a referral app, a discount engine, a tracking tool and an email tool. Yuko’s referral program covers all of that in one configuration.

​
When to use

  • During the initial launch of the referral program.
  • Any time you want to change reward values or add a sharing channel.
  • When you suspect fraud and need to tighten controls.

​
Overview

  • Enable / disable the program.
  • Configure referrer and friend rewards (see Reward Types).
  • Set the landing URL friends arrive at.
  • Enable sharing channels (Twitter / X, Facebook, Email, WhatsApp).
  • Set fraud prevention rules.
  • Configure auto-enrollment.
  • Set UTM parameters for analytics attribution.

​
Before you start

Yuko app is installed on your Shopify store — see Install Yuko on Shopify.
The Yuko Theme App Embed is enabled in your active theme.
Your loyalty program is enabled at Shopify admin → Apps → Yuko Loyalty → Loyalty → Settings.
Points label and currency are configured.
You’ve reviewed Reward Types and decided what each side gets.

​
Setup guide

​
1. Enable the program

1

Open Program Setup

In your Shopify admin, go to Apps → Yuko Loyalty → Referral → Program Setup.
2

Toggle Enable Referral Program

Turn the program on. Settings below become editable.

​
2. Configure the referrer reward

1

Open Referrer Reward

Pick the reward type the referrer gets when their friend converts. See Reward Types → Referrer reward types.
2

Set the value

Enter the points / discount value, and any expiry.
3

Cap per referrer (optional)

Limit how many successful referrals one customer can earn rewards for.

​
3. Configure the friend reward

1

Open Friend Reward

Pick the reward the friend gets on their first order. Friend rewards are discount-based only.
2

Set value and minimum

Enter the value and any minimum cart amount required.

​
4. Set the landing URL

1

Set the landing URL

The page friends are sent to after clicking the referral link. Typically /, a featured product, or a dedicated landing page (e.g., /pages/welcome).

​
5. Enable social sharing

1

Toggle channels

Pick which channels appear in the referral widget:
  • Twitter / X
  • Facebook
  • Email
  • WhatsApp
2

Customise share copy

Optional: pre-fill the message that opens in each channel.

​
6. Configure fraud prevention

1

Block self-referral

Prevent the same customer from being both referrer and friend (matched by email, IP or device).
2

Block disposable email domains

Reject referrals from temporary-email services (configured in Account & Settings → Email Blacklist).
3

Cap per IP / device

Limit how many referrals can come from the same IP or device.

​
7. Configure auto-enrollment

1

Pick enrollment mode

Every customer gets a referral link by default. Recommended.
Customers must opt in to participate. Use only if you have legal or brand reasons.

​
8. Set UTM parameters

1

Configure UTM parameters

Default UTM parameters appended to referral links: utm_source=yuko_referral, utm_medium=referral, utm_campaign=customer_referral. Customise to match your analytics taxonomy.

​
How it works

  1. Customer shares their unique referral link via the widget.
  2. Friend clicks the link and lands on your store.
  3. Yuko tracks the click via cookie + UTM.
  4. Friend places their first order and the friend reward is applied.
  5. After the order is paid, the referrer reward is issued.
  6. Activity is logged on both customer profiles.

​
Decision guidance

  • Use generous referrer rewards if you have high LTV — you make it back on the friend’s lifetime value.
  • Use clear friend rewards (an actual discount) — vague “points” rewards perform poorly for new customers.
  • Always enable fraud prevention before turning the program on.

​
Limitations

  • Referrals are tracked via cookies — privacy-blocking browsers may break attribution.
  • Only the friend’s first order qualifies; subsequent orders don’t generate referrer rewards.
  • One-active-referral per friend — a customer can’t be referred twice.

​
Examples

  • 500 points to the referrer + $10 off for the friend, capped at 5 successful referrals per customer.
  • 15% off for the friend + $20 store credit for the referrer.

​
Best practices

Test the full flow end-to-end before promoting the program: share, click, place an order, verify both sides earn.
Promote the program in your transactional emails — order confirmation and shipping emails are the highest-engagement moments.
Enable fraud prevention from day one. It’s much easier than untangling fraudulent rewards after the fact.

​
FAQs

Both rewards are reversed automatically.
With fraud prevention enabled, no. Self-referrals are blocked by email / IP / device match.
In the Customer Account hub, on the Rewards Landing Page, and in the Floating Launcher panel — see Storefront Widget.

Program Setup

Configure rewards, sharing, fraud prevention and tracking.

Reward Types

Pick the right reward for the referrer and the friend.

Storefront Widget

Add the share widget to your storefront.

Book a Free Setup Call

Talk to our team for personalised setup help.Time: 30 minutes

Contact Support

Visit our support hub for help articles, live chat and ticket submission.

Browse the Guides

Documentation across loyalty, referrals, memberships and more.

Install Yuko

Add Yuko to your Shopify store from the Shopify App Store.