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: Inside the template editor — type [ or click the shortcode picker.

​
How shortcodes work

Shortcodes are placeholders Yuko replaces with real customer or event data when the email is sent. Wrap them in square brackets, e.g., [first_name]. Not every shortcode is available in every template. The picker in the editor only shows shortcodes valid for the template you’re editing.

​
Customer shortcodes

ShortcodeReplaced with
[first_name]Customer’s first name
[last_name]Customer’s last name
[email]Customer’s email
[customer_id]Shopify customer ID
[point_balance]Current points balance
[points_label]Your configured points label (e.g., Stars)
[tier_name]Current VIP tier name

​
Event shortcodes (loyalty)

ShortcodeReplaced withUsed in
[points_value]Points earned or redeemed in the eventpoints-earned, reward-redeemed
[campaign_name]The campaign that firedpoints-earned
[reward_name]Reward redeemedreward-redeemed
[discount_code]Issued discount codereward-redeemed
[discount_expiry_date]Reward expiry datereward-redeemed, reward-expiring
[next_tier]Next tier nametier-changed
[multiplier_value]Points multipliertier-changed

​
Event shortcodes (referral)

ShortcodeReplaced withUsed in
[referrer_name]First name of the referrerreferral templates
[friend_name]First name of the friendreferral templates
[referral_link]The customer’s referral URLreferral-advocate-registered
[referral_count]Number of successful referralsreferral templates
[reward_value]The reward issuedreferral-advocate-rewarded

​
Event shortcodes (membership)

ShortcodeReplaced withUsed in
[plan_name]Membership plan namemembership templates
[plan_price]Plan price and intervalmembership-unlocked
[next_renewal_date]Next renewal datemembership-unlocked
[lost_reason]Reason for losing the planmembership-lost

​
Store shortcodes

ShortcodeReplaced with
[store_name]Your store name
[store_url]Your storefront URL
[support_email]Configured support email
[unsubscribe_url]Auto-generated unsubscribe URL (always required by law)

​
Best practices

Always test with a real customer record. Some shortcodes (e.g., [next_tier]) are empty for max-tier customers — the editor’s preview uses a sample customer that may not surface this.
Don’t put [unsubscribe_url] inside a heading. Anti-spam tools flag prominent unsubscribe links.
Use [first_name] with a sensible fallback. “Hi [first_name]” breaks if the field is empty; “Hi there” always works.

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.