Where to find this: Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Checkout: Earn points
Introduction
The Checkout: Earn points widget shows the points a customer will earn on the order, inside Shopify Checkout. It’s the Yuko Potential points earn checkout UI extension block.What problem this solves
Checkout is the last step before the order is placed. A reminder of the points the customer is about to earn reinforces the value of completing the purchase.Where it appears
- Shopify Checkout, in the order summary by default. You can move the block in the checkout editor.
When to use
- Your store is on Shopify Plus.
- You want the earn message to follow the customer all the way to payment.
Overview
- A checkout UI extension block on the
purchase.checkout.block.rendertarget, named Yuko Potential points earn. - Two text fields: a title and a message.
- No Styles tab; the block uses Shopify Checkout’s own styling.
- Recalculates as the checkout total changes.
On the Widgets list, checkout widgets show the note Available only on Shopify Plus plan when your store isn’t on Shopify Plus. This widget is also available on select Yuko plans.
Before you start
Yuko is installed on your Shopify store.
The program this widget belongs to is set up and enabled.
The widget is switched on with the toggle on its card in Yuko’s Widgets page (for loyalty widgets, Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets).
For storefront widgets, your active theme is an Online Store 2.0 theme that supports app embeds and app blocks.
Your store is on Shopify Plus.
Setup guide
1. Configure the widget in Yuko
1
Open the widget settings
Go to Loyalty → Widgets, find Checkout: Earn points under Checkout Process, and click Customize.
2
Edit the text
- Checkout earn title: default
Earn [points_label] - Checkout earn message: default
Earn up to [points_value] [points_label] for this purchase!
3
Save and enable
Click Save. Back on Loyalty → Widgets, switch the widget’s toggle on.
2. Add the block in the checkout editor
1
Open the Checkout Editor
In your Shopify admin, go to Settings → Checkout and click Customize.
2
Add the Yuko app block
Click Add app block in the section where you want the widget and choose the Yuko block for this widget (for example Yuko Potential points earn or Yuko Redeem rewards).
3
Position and save
Drag the block to its final position in the checkout and click Save.
Checkout app blocks are only available on Shopify Plus. In Yuko, the Checkout Process widgets show “Available only on Shopify Plus plan” on other Shopify plans. See Theme compatibility & requirements.
3. Verify
Start a checkout on your live store and check that the block shows the expected points.Available placeholders
How it works
- Shopify loads the Yuko Potential points earn block in checkout.
- Yuko calculates the points for the current checkout from your active earn rules.
- If the order earns points, the block shows your title and message. If it earns nothing, the block stays hidden.
- When the checkout total changes, the points are recalculated.
Limitations
- Shopify only allows checkout UI extension blocks on Shopify Plus stores.
- The block’s look follows Shopify Checkout’s styling; you can’t add custom CSS.
Best practices
FAQs
My checkout doesn't show the widget
My checkout doesn't show the widget
Check that your store is on Shopify Plus, that the Yuko Potential points earn block is added and saved in the checkout editor, that the widget toggle is on in Loyalty → Widgets, and that the order actually earns points.
What about the order status page?
What about the order status page?
Use the Order Status: Earn Points Message widget. It confirms the points earned after the order is placed.
Full placeholder reference
Placeholders are written in square brackets, for example[points_label]. Each text field’s help text in the widget editor lists the placeholders that field supports.
Available in every storefront widget text
Widget-specific placeholders
Related
Floating Rewards
Floating button and loyalty panel on every page.
Rewards Landing Page
A dedicated loyalty page built from seven theme blocks.
Loyalty Nudges
Pinned strip and drawer on every page, ideal for boosters.
Product Page Earn
Show points to earn on product pages.
Cart Earn
Show points to earn on the cart.
Cart Redeem
Let customers redeem points and apply rewards in the cart.
Checkout Earn
Show points to earn in Shopify Checkout (Shopify Plus).
Checkout Redeem
Redeem points and apply rewards in Shopify Checkout (Shopify Plus).
Order Status Earn
Show points earned on the order status page in customer accounts.
Order List Balance
Show the points balance on the Orders page in customer accounts.
Customer Profile Balance
Show loyalty details on the Profile page in customer accounts.
Customer Account Page
A full loyalty page inside Shopify customer accounts.
Branding & Locale
Colour palettes for all widgets, and per-language widget text.
Theme App Embed
The Yuko App embed that powers Floating Rewards, Loyalty Nudges and the theme blocks.
Checkout UI Extension
Add the earn and redeem blocks to Shopify Checkout (Shopify Plus).
Customer Account Extension
Add the loyalty blocks and full loyalty page to Shopify customer accounts.
Verify Your Setup
Confirm widgets render correctly on the live 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.