> ## Documentation Index
> Fetch the complete documentation index at: https://docs.munchi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Loyalty Commerce rewards

> Decide when a loyalty reward applies on the kiosk, what discount it gives and which branches offer it, using Commerce Rules in the Munchi Dashboard.

A **Commerce Rule** turns a loyalty reward into a discount the kiosk applies for you. Each rule decides three things:

* **When** the reward is offered
* **What** it takes off the price
* **Where** it is offered (which branches)

<Note>
  Loyalty Commerce currently works on the **self-service kiosk** only. When you create a rule, tick **Kiosk** and leave the other channels unticked.
</Note>

## 1. Open a loyalty reward

1. In the Munchi Dashboard sidebar, choose **Loyalty Commerce**.
2. You'll see the rewards (catalogs) in your loyalty programme. Each card shows the reward name, whether it is a **Coupon** or a **Product**, its points price, and a short summary such as `50% off · 1 condition · 1 branch`.
3. Use **Search catalogs** or the **Type** filter to find a reward.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/01-loyalty-commerce-catalogs.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=1722e02f59dc8eae0823fa32f82dd82e" alt="Loyalty Commerce page showing the rewards in your loyalty programme" width="2880" height="1800" data-path="images/loyalty-commerce-rewards/01-loyalty-commerce-catalogs.png" />

## 2. Add a Commerce Rule

1. On the reward you want, click **Configure rules**. You'll see any rules the reward already has.
2. Click **Create rule** to open the rule editor.

The editor has four steps: **1 Basics**, **2 Conditions**, **3 Reward** and **4 Branches**.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/02-rules-list.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=3bd9b0e4065e33f3d3d51af23c5afc3c" alt="Rules page for a reward, with the Create rule button" width="2880" height="1800" data-path="images/loyalty-commerce-rewards/02-rules-list.png" />

## 3. Choose where the rule applies

Under **Channels**, tick **Kiosk**. The reward is only offered in the channels you tick.

The list also shows **POS**, **Online ordering** and **Mobile app**. Leave those unticked.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/03-basics-channels.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=7ba5464d50f054ea6129a9ddaaa67e72" alt="Basics step with Kiosk ticked under Channels" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/03-basics-channels.png" />

## 4. Choose how the reward is applied

Under **How the reward is applied**, pick one:

* **Customer chooses to use it** — the reward is offered, and the customer decides to apply it.
* **Applied automatically** — the reward is applied as soon as the order qualifies.

## 5. Choose whether rewards can combine

Under **Combining with other rewards**, pick one:

* **Can combine with other rewards** — it can be used in the same order as other loyalty rewards.
* **Best single reward only** — when several rewards could apply, only the one that saves the customer the most is used.

Turn on **Can repeat in the same order** if the reward should apply again each time the conditions are met again, for example twice for two sets of qualifying items. A **Maximum applications** box then appears so you can cap how many times it applies. Leave it empty for no limit.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/04-basics-repeat-limit.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=32a96f04642c130715bf5f6a8c9c5e3f" alt="Can repeat in the same order turned on, with the Maximum applications box" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/04-basics-repeat-limit.png" />

## 6. Add conditions

Step 2 is **When does this offer apply?**

<Tip>
  **Every** condition must be met for the reward to apply. Conditions work together, not as alternatives.
</Tip>

| Condition                     | What it means                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------ |
| **No condition**              | The reward is available on every order.                                              |
| **Product in cart**           | One of the chosen products is in the cart.                                           |
| **Category in cart**          | A product from one of the chosen categories, or their subcategories, is in the cart. |
| **Product quantity in cart**  | At least the required number of units of the chosen products are in the cart.        |
| **Category quantity in cart** | At least the required number of units from the chosen categories are in the cart.    |
| **Minimum cart value**        | The cart total is at least the amount you set.                                       |
| **Maximum cart value**        | The cart total is at most the amount you set.                                        |

* Quantity conditions add a **Required quantity** box.
* Cart value conditions add a **Cart value** box. Type the amount, for example `10.00` or `10,00`. The page shows what it read next to the box (`= 10.00`).
* You pick the actual products or categories later, in step 4, because every branch has its own menu.
* Use **Add another condition** to add more. A rule needs at least one condition.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/05-condition-product-quantity.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=41ee995d5dd056953f689a2c04a04806" alt="Product quantity in cart condition with the Required quantity box" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/05-condition-product-quantity.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/06-condition-minimum-cart-value.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=1103af2a0305ba5d660181088f2522a5" alt="Minimum cart value condition with the cart value entered" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/06-condition-minimum-cart-value.png" />

## 7. Set the discount

Step 3 is **What discount or reward is given?** Choose a **Discount type**:

* **Fixed amount off** — takes a set amount of money off. For €0.50 off, type `0.50` (or `0,50`). The page shows `= 0.50 off` so you can check it.
* **Percentage off** — `10` means 10% off, and `100` makes the item free. The highest value is 100.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/07-reward-fixed-amount.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=7f47ea7ae3fe938fa076817685334437" alt="Fixed amount off with 0,50 entered, read as 0.50 off" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/07-reward-fixed-amount.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/08-reward-percentage.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=07a1aa134159550d0519baf7965d3f33" alt="Percentage off with 50 entered" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/08-reward-percentage.png" />

## 8. Choose what gets the discount

Under **What gets the discount?**, pick one:

* **Items matching the condition** — the discount goes to the same items that met the conditions.
* **Specific products** — you choose the products from each branch's menu in step 4.
* **Specific categories** — you choose the categories, including their subcategories.
* **Whole order** — the discount comes off the order total.

Choosing **Whole order** hides the item settings below, because they don't apply to a discount on the whole order.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/09-reward-target-products.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=dc550f6d94384be5e4245a520b2ffa6c" alt="Specific products chosen as what gets the discount" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/09-reward-target-products.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/10-reward-target-whole-order.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=fb1f68341c16b4de2628a142a6d38298" alt="Whole order chosen, with the item settings hidden" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/10-reward-target-whole-order.png" />

## 9. Set item and quantity limits

Under **Which items get the discount?**, pick one:

* **All matching items** — every eligible unit is discounted, up to the maximum below.
* **Cheapest matching item** — the lowest-priced units are discounted first.
* **Most expensive matching item** — the highest-priced units are discounted first.

Prices are compared per unit.

* **Units per application** appears when you choose cheapest or most expensive. It is how many discounted or free units one qualification gives. Use `1` for "buy 2, get 1 free".
* **Maximum discounted units** caps how many units can be discounted in one order. Leave it empty for no limit.

Under **How the reward item is chosen**, pick one:

* **Reward item must already be in cart** — the discount applies to eligible items the customer already added.
* **Choose reward item** — eligible items must be in the cart, and the customer picks which one gets the reward.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/11-reward-selection-units.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=27bf2d821411bfb7a8f404891a70a43d" alt="Cheapest matching item chosen, with Units per application" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/11-reward-selection-units.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/12-reward-fulfilment.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=37b996eea4f49d977b3dfb10e6122acc" alt="How the reward item is chosen, with Reward item must already be in cart selected" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/12-reward-fulfilment.png" />

## 10. Choose the branches

Step 4 is **Where does it apply?** Under **Offer this rule at**, turn on every branch where the rule should apply.

Each branch has its own menu, so you choose items separately for each branch. For every branch you turn on, you'll see:

* **Condition items** — choose the products or categories that meet each condition.
* **Reward items** — if you chose **Specific products** or **Specific categories**, choose what gets the discount.
* **Exclude items from the discount** — items that never get the discount, even when they match.
* **Use different values at this branch** — change the discount value or the limits for that branch only. Empty fields use the rule's own values.

<Info>
  In the menu picker, choosing a product means exactly that product. Choosing a category includes all of its subcategories and their products.
</Info>

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/13-branches-scope.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=3d4c450fc96744d872f60b03e53e3a4d" alt="Offer this rule at, with a branch turned on" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/13-branches-scope.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/14-branch-menu-picker.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=59bcd3d0ecfa8e4c968860b3694b34bc" alt="Branch menu picker with one product selected" width="2880" height="1800" data-path="images/loyalty-commerce-rewards/14-branch-menu-picker.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/15-branch-items-chosen.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=ad6fc5c26a1169a920f2267411b1c6aa" alt="Branch card after the condition items are chosen" width="1440" height="1800" data-path="images/loyalty-commerce-rewards/15-branch-items-chosen.png" />

## 11. Save the rule

Click **Save**. You'll see **Reward rule created**, and the rule appears in the list.

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/16-rule-saved.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=965fe4ed86bdf8182ddcf5a668d16cbd" alt="Reward rule created confirmation after clicking Save" width="2880" height="1800" data-path="images/loyalty-commerce-rewards/16-rule-saved.png" />

<img src="https://mintcdn.com/munchi/LgE4gFcySQL-kmmC/images/loyalty-commerce-rewards/17-rules-list-with-new-rule.png?fit=max&auto=format&n=LgE4gFcySQL-kmmC&q=85&s=db88c9bc91cd7c302af23f1e87a5326a" alt="Rules list showing the new rule" width="2880" height="1800" data-path="images/loyalty-commerce-rewards/17-rules-list-with-new-rule.png" />

### If the rule doesn't save

If something is missing, you'll see **The rule couldn't be saved**. The problems are listed and marked on the step that needs fixing. Common messages:

* *Choose at least one channel.*
* *Add at least one condition.*
* *Turn on at least one branch.*
* *Choose items from \<branch>'s menu for \<condition>.*
* *Maximum applications can only be set when the reward can repeat.*
* *The minimum cart value can't be higher than the maximum cart value.*

If you see **Someone else saved this rule first**, another person saved the same rule while you were editing. Reload the rule and make your changes again.

## Examples

### €0.50 off one specific product

Condition **Product in cart** → discount **Fixed amount off** `0.50` → target **Items matching the condition** → **Maximum discounted units** `1` → turn on the branch and pick the product.

### 50% off one selected product

Condition **Product in cart** → discount **Percentage off** `50` → target **Items matching the condition** → **Maximum discounted units** `1` → pick the product for each branch.

### A discount when a specific product is in the basket

Condition **Product in cart** (the product that must be there) → target **Specific products** (what actually gets the discount) → choose both lists for each branch.

### A discount when a selected category is in the basket

Condition **Category in cart** → any discount → target **Items matching the condition** or **Specific categories**. A category always includes its subcategories.

### Buy 2, get 1 free

Condition **Product quantity in cart** with **Required quantity** `2` → discount **Percentage off** `100` → target **Items matching the condition** → **Cheapest matching item** → **Units per application** `1`.

### A reward when the cart reaches a minimum amount

Condition **Minimum cart value**, for example `25.00` → discount **Fixed amount off** `5.00` → target **Whole order**.

## Common questions

### Do conditions work as "and" or "or"?

As "and". Every condition must be met.

### Does a category include its subcategories?

Yes. Choosing a category includes all of its subcategories and their products.

### Which currency is used?

The order's own currency. There's nothing to set.

### Who can create rules?

Dashboard admins.

### Can I undo archiving a rule?

No. **An archived rule stops applying straight away and can't be restored.**

### Does a Commerce Rule decide who gets the reward?

No. Who can receive or use a reward — chosen users, tiers, birthdays, how often it can be used, when it expires, how many are available, and its points price — is set on the reward itself. A Commerce Rule only decides what happens in the cart. Don't rebuild those settings as conditions.
