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 → Cart Redeem

​
Introduction

The Cart Redeem widget is the central redemption surface on your storefront. It shows the customer’s balance, rewards they’ve already earned, rewards they can claim, and (optionally) their VIP tier progress — with a one-click apply flow at the cart.

​
What problem this solves

Customers regularly forget they have points or rewards. A redemption widget at the cart removes the friction: they see what they have, what they can use right now, and they can apply it without leaving the page.

​
Where it appears

  • Cart page and cart drawer (theme-dependent).

​
When to use

  • You want to drive redemption rate.
  • You want a visible loyalty hub at the moment of purchase decision.
  • You want to highlight VIP benefits without a separate page.

​
Overview

  • Displays the customer’s points balance.
  • Lists active rewards the customer has earned.
  • Lists redeemable rewards (Ways to Redeem) the customer can claim.
  • Optional VIP status section with tier progress.
  • Separate logged-in and logged-out copy.
  • Fully customisable messages, button labels and icons.

​
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.
You’ve configured at least one Way to Redeem.

​
Setup guide

​
1. Configure in Yuko

1

Open the widget settings

Go to Apps → Yuko Loyalty → Loyalty → Widgets → Cart Redeem.
2

Configure the logged-in state

  • Point balance message — default: “You have: [point_balance] [points_label]”
  • Reward button text — e.g., “Redeem rewards”
3

Configure the logged-out state

  • Toggle Hide widget for logged-out users if you prefer.
  • Login prompt — default: “Log in to redeem your [points_label] for rewards.”
  • Log in button text — e.g., “Log in”
4

Configure the redemption view

Customise:
  • Heading — “Redeem rewards”
  • Existing rewards title — “Your rewards”
  • Ways to redeem title — “Available rewards”
  • Redeem button text — “Redeem”
  • Apply button text — “Apply code”
  • Reward expiry message — “Reward expires on [discount_expiry_date]”
5

Configure VIP status (optional)

Show the customer’s tier and next-tier progress:
  • VIP status title — e.g., “VIP Status”
  • Next tier message — “Next tier: [next_tier]”
  • Max tier message — “You’ve reached the top tier!”
6

Set custom placement

Optional: control where in the cart the widget renders.
7

Activate

Toggle the widget Active.

​
2. Add the widget to your theme

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.
Pick the Cart template (and the cart drawer if applicable). Place the widget near the checkout button.

​
3. Verify

1

Test logged-in state

Log in as a customer with points and confirm the balance and rewards render.
2

Test logged-out state

Open the cart in a private window. Confirm the login prompt renders (or the widget is hidden, per your config).
3

Test VIP section

If VIP is enabled, confirm the tier and progress show correctly.
4

Test redemption flow

Apply a reward and verify the discount appears at checkout.

​
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. The widget loads the customer’s points balance and reward state from Yuko.
  2. For logged-out customers, it shows the login prompt (or hides itself).
  3. For logged-in customers, it shows balance, earned rewards, and claimable rewards.
  4. Clicking Redeem issues a Shopify discount code unique to the customer.
  5. Clicking Apply code copies the code (or auto-applies it) to the cart.
  6. The discount is then visible at checkout.

​
Decision guidance

  • Always show the VIP section if you have tiers — it drives upgrade behaviour.
  • Use the logged-out login prompt rather than hiding the widget — it’s a clean acquisition CTA.
  • Place near the checkout button for the best conversion-to-redemption ratio.

​
Limitations

  • Auto-apply behaviour depends on theme support; on some themes the customer needs to manually paste the code.
  • VIP section requires VIP tiers to be enabled.
  • Cart drawer rendering is theme-dependent.

​
Examples

  • Premium beauty brand: Cart Redeem at the bottom of the cart drawer, with the VIP section visible. Average redemption rate up 38% within 30 days of launch.
  • DTC apparel: Cart Redeem near the checkout button, login prompt enabled — doubles as a sign-up nudge.

​
Best practices

Pair with Cart Earn. Customers should see what they’re earning and what they can spend.
Keep button labels in active voice. “Redeem” is better than “Claim Reward”.
Don’t hide the logged-out state. It’s a sign-up opportunity disguised as a widget.

​
FAQs

The widget shows their balance and the available Ways to Redeem they’re closest to qualifying for.
Yes — enable auto-apply in the configuration. Theme support for auto-applied codes varies; verify on your store.
Either VIP is not enabled, or the customer hasn’t been assigned a tier yet (assignment can take a few minutes after first qualifying activity).
Reward visibility follows your campaign exclusions and customer eligibility from Loyalty Settings.

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.