> ## 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.

# Checkout Redeem Widget

> Let customers apply their loyalty rewards directly inside Shopify Checkout.

<Note>
  **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Checkout Redeem
</Note>

## Introduction

Let customers apply their points or earned rewards as a discount code natively inside Shopify Checkout, without bouncing back to cart.

## What problem this solves

The biggest leak in any loyalty program is between *“customer wants to redeem”* and *“discount code applied at checkout”*. Bringing redemption into checkout shrinks that gap to a single click.

## Where it appears

* Shopify Checkout (information, shipping, payment pages), typically next to the discount code field.

## When to use

* You're on Shopify Plus or a plan with Checkout Extensibility.
* You want to lift redemption rate at the most decisive screen.
* You want loyalty discounts to feel native, not bolt-on.

## Overview

* Renders inside Shopify Checkout via the Checkout UI extension.
* Lists the customer's available rewards.
* One-click apply.
* Customisable copy and CTA.
* Plan-gated by Shopify.

## Before you start

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

<Check>Your Shopify plan supports Checkout Extensibility.</Check>
<Check>The Checkout UI extension has been activated — see [Activate the Checkout UI Extension](/installation-and-setup/checkout-ui-extension).</Check>
<Check>You have at least one [Way to Redeem](/loyalty/ways-to-redeem/overview) configured.</Check>

## Setup guide

### 1. Configure in Yuko

<Steps>
  <Step title="Open the widget settings">
    Go to **Apps → Yuko Loyalty → Loyalty → Widgets → Checkout Redeem**.
  </Step>

  <Step title="Configure the heading">
    e.g., *“Use your `[points_label]`”* or *“You have rewards available”*.
  </Step>

  <Step title="Configure the apply CTA">
    e.g., *“Apply”* or *“Use this reward”*.
  </Step>

  <Step title="Activate">
    Toggle the widget **Active**.
  </Step>
</Steps>

### 2. Add the widget in Shopify Checkout

<Steps>
  <Step title="Open the Checkout Editor">
    In your Shopify admin, go to **Settings → Checkout → Customize**.
  </Step>

  <Step title="Add the Yuko Checkout extension">
    In the editor, click **Add app block** in the section where you want the widget. Choose the relevant Yuko Checkout extension.
  </Step>

  <Step title="Position and save">
    Drag the block to its final position in the checkout and click **Save**.
  </Step>
</Steps>

<Info>
  Checkout UI extensions require **Shopify Plus** or a checkout-eligible plan. See [Theme compatibility & requirements](/getting-started/theme-compatibility).
</Info>

Place the widget near the discount code field for maximum redemption.

### 3. Verify

Log in as a customer with rewards, proceed to checkout and confirm the rewards list renders. Apply a reward and verify the discount adjusts the order total.

## How it works

1. Shopify renders the Yuko Checkout Redeem extension at checkout.
2. The extension fetches the customer's available rewards.
3. The customer clicks **Apply** on a reward.
4. The corresponding Shopify discount code is applied to the order.

### Decision guidance

* **Place near the discount code field** so customers find it where they expect to.
* **Show only the highest-value reward** if the list gets crowded — customers struggle with too many options here.

### Limitations

* Requires Checkout Extensibility (Shopify Plus / eligible plans).
* Visual customisation is constrained by Shopify's extension surface.
* Stacking with other discounts is gated by Shopify's combinability rules.

## Examples

* *“You have rewards available”* with two rewards listed and one-click apply.

## Best practices

<Tip>**Don't hide the cart redeem widget when checkout redeem is enabled.** They serve different stages of intent; both lift redemption together.</Tip>
<Tip>**Order rewards by value descending.** Customers click the first one that fits.</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="What if a customer has no rewards?">
    The widget hides itself for that customer.
  </Accordion>

  <Accordion title="Can a customer apply multiple rewards?">
    Only if Shopify combinability rules allow it. By default, one discount code per order.
  </Accordion>

  <Accordion title="Why doesn't auto-apply work?">
    Auto-apply behaviour depends on the type of reward and Shopify's discount engine. Some reward types require manual apply.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="Loyalty Nudges" icon="bell" href="/onsite-widgets/loyalty-nudges">
    Pinned strip + drawer on every page — your booster promotion surface.
  </Card>

  <Card title="Product Page Earn" icon="bag-shopping" href="/onsite-widgets/product-page-earn">
    Show points earnable on product detail pages.
  </Card>

  <Card title="Cart Earn" icon="cart-plus" href="/onsite-widgets/cart-earn">
    Show total earnable points in cart.
  </Card>

  <Card title="Cart Redeem" icon="gift" href="/onsite-widgets/cart-redeem">
    Surface points balance and rewards in cart.
  </Card>

  <Card title="Checkout Earn" icon="cash-register" href="/onsite-widgets/checkout-earn">
    Show earnable points inside Shopify Checkout.
  </Card>

  <Card title="Checkout Redeem" icon="ticket" href="/onsite-widgets/checkout-redeem">
    Apply rewards inside Shopify Checkout.
  </Card>

  <Card title="Order Status Earn" icon="circle-check" href="/onsite-widgets/order-status-earn">
    Confirm earned points on the thank-you page.
  </Card>

  <Card title="Order List Balance" icon="receipt" href="/onsite-widgets/order-list-balance">
    Show points balance on the order history page.
  </Card>

  <Card title="Customer Profile Balance" icon="id-badge" href="/onsite-widgets/customer-profile-balance">
    Show balance on the customer profile.
  </Card>

  <Card title="Customer Account Page" icon="user" href="/onsite-widgets/customer-account-page">
    Loyalty hub inside Shopify customer accounts.
  </Card>

  <Card title="Rewards Landing Page" icon="window-maximize" href="/onsite-widgets/rewards-landing-page">
    Standalone loyalty page for your storefront.
  </Card>

  <Card title="Floating Launcher" icon="circle-arrow-up" href="/onsite-widgets/floating-launcher">
    Persistent loyalty panel on every page.
  </Card>

  <Card title="Branding & Locale" icon="palette" href="/onsite-widgets/branding-and-locale">
    Cross-widget styling, icons and language.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Theme App Embed" icon="plug" href="/installation-and-setup/theme-app-embed">
    Required to render any storefront widget.
  </Card>

  <Card title="Checkout UI Extension" icon="cart-shopping" href="/installation-and-setup/checkout-ui-extension">
    Show points and rewards inside Shopify checkout.
  </Card>

  <Card title="Customer Account Extension" icon="user" href="/installation-and-setup/customer-account-extension">
    Add the loyalty hub inside Shopify customer accounts.
  </Card>

  <Card title="Verify Your Setup" icon="circle-check" href="/installation-and-setup/verify-setup">
    Confirm widgets render correctly on the live storefront.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Book a Free Setup Call" icon="phone" href="https://cal.com/rameshelamathi/yuko-demo">
    Talk to our team for personalised setup help.

    **Time:** 30 minutes
  </Card>

  <Card title="Contact Support" icon="life-ring" href="https://yuko.so/support/">
    Visit our support hub for help articles, live chat and ticket submission.
  </Card>

  <Card title="Browse the Guides" icon="book" href="/getting-started/welcome">
    Documentation across loyalty, referrals, memberships and more.
  </Card>

  <Card title="Install Yuko" icon="shop" href="https://apps.shopify.com/yuko">
    Add Yuko to your Shopify store from the Shopify App Store.
  </Card>
</CardGroup>
