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

# Percentage Discount

> Let customers redeem points for a percentage discount, with an optional cap on the discount amount.

<Note>
  **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Loyalty → Programs → Ways to redeem → Add another way → **Percentage Discount**
</Note>

## Introduction

Let customers spend points on a percentage discount (for example, `1,000 points = 10% off`). Bigger orders get a bigger reward, and you can cap it with a **Maximum Discount Amount**.

## What problem this solves

Flat discounts under-reward big spenders. A percentage discount scales with the cart, so a customer placing a $300 order gets a meaningfully bigger reward than one on a $40 order. The cap keeps very large orders from producing a discount you didn't plan for.

## When to use

* You sell higher-priced products where 10–20% is meaningful.
* You want the reward to scale with order size.
* You want a percentage off specific products or collections only.

## Overview

* Percentage off, from 1% to 50%.
* Optional **Maximum Discount Amount** to cap the discount.
* Optional **Coupon Prefix**, **Purchase type** and product or collection targeting.
* Optional minimum purchase amount or minimum quantity of items.
* Optional combinations with other discounts and an optional expiry.

## Before you start

<Check>Yuko app is installed on your Shopify store — see [Install Yuko on Shopify](/installation-and-setup/install-on-shopify).</Check>
<Check>The Yuko **Theme App Embed** is enabled in your active theme — see [Theme App Embed](/installation-and-setup/theme-app-embed).</Check>
<Check>Your loyalty program is enabled under **Loyalty Program Status** at **Shopify admin → Apps → Yuko Loyalty → Loyalty → Programs**.</Check>
<Check>Your point labels are set in [Loyalty Settings](/loyalty/program-settings).</Check>

## Setup guide

<Steps>
  <Step title="Add the reward">
    In your Shopify admin, go to **Apps → Yuko Loyalty → Loyalty → Programs**. In **Ways to redeem**, click **Add another way** and pick **Percentage Discount** under **Online Store**.
  </Step>

  <Step title="Fill in Basic Details">
    Set the **Reward Name** (shortcodes `[reward_value]`, `[points_required]` and `[points_label]` are supported) and a **Description**.
  </Step>

  <Step title="Complete the Reward Configuration">
    * **Points Required** — the points cost.
    * **Percentage Discount** — a whole number from 1 to 50.
    * **Maximum Discount Amount** — caps the discount at this amount. Leave it empty for no limit.
    * **Coupon Prefix** — the start of every code (up to 8 characters, default `yuko`).
    * **Purchase type** — **One-time purchase**, **Subscription** or **Both** (default). Subscription options only take effect if your store sells subscriptions.
    * **Applies to specific products or collections** — leave unchecked to discount the whole order. When checked, choose **Specific products** or **Specific collections** and select at least one.
  </Step>

  <Step title="Set Minimum Requirements (optional)">
    Choose **No minimum requirements**, **Minimum purchase amount** (**Minimum Subtotal**) or **Minimum quantity of items** (**Minimum Quantity**).
  </Step>

  <Step title="Choose combinations (optional)">
    Under **Combine with other discounts**, tick any of **Product discount**, **Order discount** and **Free shipping**.
  </Step>

  <Step title="Set Expiry (optional)">
    Turn on **Expiry** and set **Expire after** and a **Period** (Day, Week, Month or Year). Expiry is available on select plans.
  </Step>

  <Step title="Enable and save">
    Turn on **Status** in the side panel and click **Save**.
  </Step>
</Steps>

## How it works

1. The customer redeems the reward from a loyalty widget.
2. Yuko deducts the points and creates a single-use Shopify discount code for that customer.
3. The percentage applies to the eligible items at checkout.

### How the Maximum Discount Amount works

Shopify's standard percentage codes can't be capped. So when you set a **Maximum Discount Amount**, Yuko creates the code as a Shopify app discount that runs on Yuko's discount function, **Percentage discount (Yuko)**. The function applies your percentage and stops at the cap. It also respects the minimum requirement, purchase type and products or collections you chose.

In **Shopify admin → Discounts**, these codes show a **Yuko discount details** panel with the discount, maximum discount, minimum requirement, purchase type and what it applies to. You can't edit their settings there; you can only deactivate or delete them. To change future codes, edit the reward in Yuko.

Without a cap, Yuko creates a standard Shopify percentage discount code.

### Decision guidance

* **Set a Maximum Discount Amount** for higher percentages. Without it, a $2,000 order at 20% off produces a $400 discount.
* **Target specific collections** to keep the discount off sale items or low-margin products.

### Limitations

* The maximum percentage is 50%.
* The code is a Shopify discount, so Shopify's combination rules apply.
* Shopify percentage discounts don't reduce taxes or shipping.

## Examples

* *Higher-priced store:* `1,000 pts = 10% off`, Maximum Discount Amount $50, Minimum Subtotal $100.
* *Apparel store:* `2,000 pts = 15% off` a "New arrivals" collection, expires after 30 days.

## Best practices

<Tip>**Set a cap for anything above 5–10%.** It protects margin on unusually large orders.</Tip>
<Tip>**Leave combinations off with sale promos** unless you've modelled the impact.</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="Why does the discount show as an app discount in Shopify?">
    Because you set a Maximum Discount Amount. Capped codes run on Yuko's discount function so the cap can be enforced. Uncapped codes are standard Shopify percentage codes.
  </Accordion>

  <Accordion title="Can the discount apply to taxes or shipping?">
    No. It applies to the eligible items only, before tax and shipping.
  </Accordion>

  <Accordion title="What's the difference from Amount Discount?">
    Percentage scales with cart value; Amount Discount is a fixed value and also supports incremented points.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Amount Discount" icon="tag" href="/loyalty/ways-to-redeem/amount-discount">
    Fixed amount off in exchange for points.
  </Card>

  <Card title="Percentage Discount" icon="percent" href="/loyalty/ways-to-redeem/percentage-discount">
    Percentage off, with an optional maximum discount amount.
  </Card>

  <Card title="Free Product" icon="box" href="/loyalty/ways-to-redeem/free-product">
    A chosen product at no cost.
  </Card>

  <Card title="Free Shipping" icon="truck" href="/loyalty/ways-to-redeem/free-shipping">
    Free shipping, with optional country and rate restrictions.
  </Card>

  <Card title="Store Credit" icon="wallet" href="/loyalty/ways-to-redeem/store-credit">
    Convert points into Shopify store credit.
  </Card>

  <Card title="POS Amount Discount" icon="cash-register" href="/loyalty/ways-to-redeem/pos-amount-discount">
    Fixed amount off, redeemed in-store at Shopify POS.
  </Card>

  <Card title="POS Percentage Discount" icon="store" href="/loyalty/ways-to-redeem/pos-percentage-discount">
    Percentage off, redeemed in-store at Shopify POS.
  </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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.