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 → Notifications
Referrals have three distinct email moments. Each maps to a built-in template you can customise in the Template Editor.

​
Advocate Registered

Trigger: A customer becomes a referrer — either by being auto-enrolled when they reach the criteria, or when they manually opt in. Default subject: “Here’s your referral link, [first_name]” Default body summary: Greeting → program explanation (what the friend gets, what the referrer gets) → the referral link → share buttons. Useful shortcodes: [first_name], [referral_link], [reward_value].
Make this the most-polished email in the program. It’s the one that actually drives shares.

​
Friend Reward Claimed

Trigger: A friend’s reward has been issued (their first qualifying order completed). Default subject: “Your [reward_value] discount is ready” Default body summary: Greeting → reward name + discount code → expiry → CTA to redeem. Useful shortcodes: [first_name], [reward_value], [discount_code], [discount_expiry_date].
Send this to the friend, not the referrer. The friend is the new customer being onboarded.

​
Advocate Rewarded

Trigger: A referrer’s reward has been issued (after their friend’s order is paid). Default subject: “Your referral worked! Here’s your reward” Default body summary: Greeting → the friend converted → referrer’s reward (points / discount / store credit) → CTA to keep sharing. Useful shortcodes: [first_name], [friend_name], [reward_value], [referral_count].
Always include the referral count — it gives top referrers a reason to keep going.

​
Best practices

Pair Advocate Registered with the Referrals widget. The widget is the daily surface; the email is the one-time “you’re in the program” moment.
Test all three with a real referral flow. Place a test referral order to verify both Friend Reward and Advocate Rewarded fire correctly.
Don’t over-promote. A flood of “your friend signed up” emails feels spammy.

​
FAQs

Both rewards are reversed automatically. No additional emails are sent for the reversal.
The Advocate Rewarded email serves that purpose. For richer behaviour (e.g., milestone emails after 5 successful referrals), use Workflows.

Loyalty Emails

Points earned, redeemed, tier changes and expiry reminders.

Referral Emails

Friend reward, advocate registered and rewarded.

Membership Emails

Membership unlocked and lost notifications.

Template Editor

Customise content and visual design.

Shortcodes Reference

All merge tags available across templates.

Sender & Branding

Configure the from address, logo and colors.

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.