Skip to main content
Where to find this: Shopify admin → Apps → Yuko Loyalty → Referral → Widgets → Post-Purchase Widget

​
Introduction

The Post-Purchase Widget asks customers to refer a friend straight after checkout. It’s the Yuko Referral Signup extension block, shown on the thank-you page and on the order status page in customer accounts.

​
What problem this solves

Customers are most enthusiastic right after buying. Showing the referral offer at that moment, with a one-click way to get a link, turns that enthusiasm into referrals.

​
Where it appears

  • The Thank you page (purchase.thank-you.block.render).
  • The Order status page in Shopify customer accounts (customer-account.order-status.block.render).

​
Overview

  • Four text fields: title, description and two button labels.
  • No Styles tab. The block uses Shopify’s checkout and customer account styling.
  • A customer who isn’t a referrer yet sees Get referral link. Clicking it enrolls them and shows their link with a copy button. Existing referrers see their link straight away.

​
Before you start

The referral program is enabled and a friend reward is set in Referral → Program. The widget stays hidden without a friend reward.
For the order status page, your store uses Shopify customer accounts (Settings → Customer accounts).

​
Setup guide

​
1. Configure the widget in Yuko

1

Open the widget

Go to Referral → Widgets and open Post-Purchase Widget.
2

Edit the content

In Title and Description, use {{friend_reward}} and {{referrer_reward}} to insert the reward titles, so the text stays in sync with your rewards.
3

Save and enable

Click Save, then switch the toggle next to the widget title on. The badge changes to Active.

​
2. Add the block to the thank-you page

1

Open the checkout editor

In your Shopify admin, go to Settings → Checkout and click Customize.
2

Open the Thank you page

Use the page selector at the top to switch to Thank you.
3

Add the block

Click Add app block, choose Yuko Referral Signup, position it and click Save.

​
3. Add the block to the order status page

1

Open the Customer Accounts editor

In your Shopify admin, go to Settings → Customer accounts and click Customize.
2

Open the right page

Use the page selector at the top to open the page where the block should appear (Order status, Orders, or Profile).
3

Add the Yuko app block

Click Add app block and choose the Yuko block for this widget (for example Yuko Order status earned points, Yuko Order index points display or Yuko Profile loyalty program).
4

Position and save

Position the block where customers will see it and click Save.
Customer account blocks only work with Shopify’s new customer accounts. Check that they’re turned on in Settings → Customer accounts.
On the Order status page, add the Yuko Referral Signup block.

​
4. Verify

Place a test order and check that the widget appears on the thank-you page. Click Get referral link, then copy the link and open it in a private window to check that the Friend Welcome Popup appears.

​
How it works

  1. The block checks that the referral module is on, a friend reward exists and the widget is enabled.
  2. If the customer already has a referral code, the block shows their link.
  3. Otherwise the block shows Get referral link. Clicking it enrolls the customer as a referrer and shows the new link.
  4. The customer copies the link and shares it.

​
Limitations

  • The block’s look follows Shopify’s checkout and customer account styling.
  • The order status target needs Shopify customer accounts and a logged-in customer.

​
FAQs

Thank-you and order status page blocks don’t require Shopify Plus. Checkout-step blocks, such as the loyalty checkout widgets, do.
Check that a friend reward is set, the widget’s toggle is on, and the Yuko Referral Signup block is added to the page you’re looking at.

Program Setup

Rewards, landing URL, sharing, fraud prevention and UTM tracking.

Reward Types

Pick the right reward for the referrer and the friend.

Referral Widgets

Post-Purchase Widget, Referral Landing Page and Friend Welcome Popup.

Referral Emails

The emails sent to referrers and friends.

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.