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 → Cart Earn
Introduction
Display the cumulative points a customer will earn for the items currently in their cart — right next to the cart total.What problem this solves
The cart is the highest-intent screen on your storefront. A customer staring at a $200 cart is far more likely to complete checkout if they see “200 points earned on this order” attached to it.Where it appears
- Cart page or cart drawer (theme-dependent).
When to use
- You want to lift cart-to-checkout conversion.
- You want to remind customers of the loyalty value before they leave the cart.
Overview
- Calculates total earnable points based on cart contents.
- Updates dynamically as the cart changes.
- Customisable message and icon.
- Optional custom placement.
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
Set custom placement (optional)
Use the placement option to control where in the cart the widget renders.
2. Add the widget to your theme
Open the Theme Editor
In your Shopify admin, go to Online Store → Themes, find your active theme, and click Customize.
Pick the right template
Use the template selector at the top to open the page where this widget should appear (Product, Cart, etc.).
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.
3. Verify
Add products to your live cart and confirm the widget renders with the correct total.Available placeholders
| Placeholder | Replaced 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
- Customer adds products to cart.
- The widget reads the cart contents and applies active earning rules.
- The total earnable points are rendered.
- The widget refreshes whenever the cart changes (add, remove, quantity).
Decision guidance
- Place near the checkout button for conversion.
- Place near the total for visibility.
- Use both cart page and drawer if your theme supports both.
Limitations
- Cart drawer support depends on your theme. Some themes need additional setup.
- The widget displays the calculation at the moment of render — expired session data may show briefly.
Examples
- “You’ll earn 80 Stars on this purchase!” with a star icon next to the checkout button.
Best practices
FAQs
Why doesn't my cart drawer show the widget?
Why doesn't my cart drawer show the widget?
Theme-dependent. Some themes require enabling app blocks in the drawer or using the Floating Launcher instead.
What does the value show for guest customers?
What does the value show for guest customers?
The base earning rate without any VIP multiplier.
Related
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.