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 → Loyalty → Widgets → Order Status Earn

​
Introduction

Display an earned-points confirmation on the Shopify thank-you (order status) page. Customers see “You earned 200 Stars on this order!” the second their checkout completes.

​
What problem this solves

Momentum is at its peak immediately after a customer pays. Confirming the earned reward in that moment cements the program in their mind and seeds the next purchase.

​
Where it appears

  • The Shopify Thank-you / Order Status page.

​
When to use

  • Always — this widget works on every Shopify plan.
  • It’s a baseline confirmation that the loyalty program is real and working.

​
Overview

  • Renders on the Order Status page.
  • Confirms the points awarded for this order.
  • Customisable message.
  • Works on all Shopify plans.

​
Before you start

Yuko app is installed on your Shopify store.
Your loyalty program is enabled.
The widget is set to Active in Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets.
Your active Shopify theme supports Online Store 2.0 app blocks.

​
Setup guide

​
1. Configure in Yuko

1

Open the widget settings

Go to Apps → Yuko Loyalty → Loyalty → Widgets → Order Status Earn.
2

Configure the message

Default: “You earned [points_value] [points_label] on this order!”.
3

Activate

Toggle the widget Active.

​
2. Add to Shopify

1

Open the Theme Editor

In your Shopify admin, go to Online Store → Themes, find your active theme, and click Customize.
2

Pick the right template

Use the template selector at the top to open the page where this widget should appear (Product, Cart, etc.).
3

Add the Yuko app block

Click Add block in the section where you want the widget. Under Apps, select the Yuko block listed for this widget.
4

Position and save

Drag the block to your preferred position and click Save.
When choosing the template, pick the Thank you / Order status page (also called the Post-purchase page in some Shopify accounts).

​
3. Verify

Place a real test order. After completing checkout, confirm the widget renders on the thank-you page with the correct points.

​
Available placeholders

PlaceholderReplaced with
[points_value]The numeric points value (per product, per cart or per order, depending on widget).
[points_label]Your configured points label (e.g., Points, Stars, Coins).
[point_balance]The customer’s current points balance.
[discount_expiry_date]The date a redeemed reward expires.
[next_tier]Name of the customer’s next VIP tier.
[tier_entry_amount]Spend or points threshold to reach the next tier.
[multiplier_value]Points multiplier applied at the customer’s current tier.

​
How it works

  1. Customer completes checkout.
  2. Shopify renders the order status page.
  3. The widget reads the just-completed order and displays the earned points.

​
Decision guidance

  • Always run this widget. It’s free credibility for the program.
  • Pair with a points-earned email — the customer sees the confirmation onsite and by email.

​
Limitations

  • The widget shows the points awarded based on order value at completion. If a delay is configured, the widget says “will earn” and the credit lands later.
  • Refunds reverse points but don’t update this widget retroactively (the page is a static record of the completed order).

​
Examples

  • “You earned 200 Stars on this order!” with a star icon.

​
Best practices

Match the message tone to the rest of your post-purchase comms. This page is the brand handshake.

​
FAQs

Either the order doesn’t qualify for any active campaigns or a delay is configured — in which case the message should reflect “will earn”.
The order status page is intentionally a confirmation surface. Use the Customer Account Page for redemption.

Product Page Earn

Show points earnable on product detail pages.

Cart Earn

Show total earnable points in cart.

Cart Redeem

Surface points balance and rewards in cart.

Checkout Earn

Show earnable points inside Shopify Checkout.

Checkout Redeem

Apply rewards inside Shopify Checkout.

Order Status Earn

Confirm earned points on the thank-you page.

Order List Balance

Show points balance on the order history page.

Customer Profile Balance

Show balance on the customer profile.

Customer Account Page

Loyalty hub inside Shopify customer accounts.

Rewards Landing Page

Standalone loyalty page for your storefront.

Floating Launcher

Persistent loyalty panel on every page.

Branding & Locale

Cross-widget styling, icons and language.

Theme App Embed

Required to render any storefront widget.

Checkout UI Extension

Show points and rewards inside Shopify checkout.

Customer Account Extension

Add the loyalty hub inside 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.