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

# Discount coupons for online orders

> Create and manage promo codes customers can apply at checkout on your online storefront. Control discount type, usage limits, valid dates, and which order types and branches each coupon applies to.

Coupons let you offer customers a discount code they enter at checkout when placing an online order. You set the rules — how much off, which order types qualify, how many times the code can be used, and when it expires. Coupons apply to the order total; they are different from [item promotions](/menu/promotions), which reduce the price of individual menu items.

<Note>
  You need the **Manage Settings** permission to create or edit coupons.
</Note>

## Opening the coupons manager

In the web admin, go to **Menu > Promotions** and select the **Shop Coupons** link, or navigate to **Settings > Shop Coupons**.

The coupons list shows all existing codes with their status, discount, and validity window. From here you can create, edit, activate, deactivate, or delete any coupon.

## Creating a coupon

<Steps>
  <Step title="Open the new coupon form">
    Click **Add coupon** (or the equivalent create button) in the coupons manager.
  </Step>

  <Step title="Set the code and description">
    Enter a unique **Coupon code** (up to 50 characters). This is exactly what customers type at checkout — it is case-sensitive, so keep it simple. Optionally add a **Description** for your own reference; customers do not see it.
  </Step>

  <Step title="Choose the discount type and value">
    Select a **Discount type**:

    * **Percent** — takes a percentage off the order subtotal.
    * **Fixed amount** — deducts a flat currency amount.

    Then enter the **Discount value** (the percentage number or the fixed amount).
  </Step>

  <Step title="Set minimum order and maximum discount (optional)">
    * **Minimum order amount** — the coupon will not apply if the cart is below this value. Leave blank for no minimum.
    * **Maximum discount amount** — only available when the discount type is **Percent**. Caps the discount so a large order does not receive an unlimited saving. Leave blank for no cap.
  </Step>

  <Step title="Set usage limits (optional)">
    * **Usage limit** — the maximum number of times this code can be redeemed across all customers combined. Leave blank for unlimited.
    * **Usage limit per customer** — the maximum number of times a single customer can use this code. Leave blank for unlimited.
  </Step>

  <Step title="Set the validity window">
    Choose a **Valid from** date/time and a **Valid to** date/time. Outside this range the coupon will be rejected at checkout even if it is marked active.
  </Step>

  <Step title="Select applicable order types">
    Tick the order types this coupon should work for: **Delivery**, **Pickup**, and/or **Dine-in**. A customer placing a pickup order, for example, cannot use a delivery-only coupon.
  </Step>

  <Step title="Assign to specific branches (optional)">
    By default the coupon applies to all branches. To restrict it, select one or more branches from the **Branch** selector. Leave it unset to make the coupon valid across every branch.
  </Step>

  <Step title="Activate and save">
    Tick **Is active** to make the coupon live immediately (within its validity window). Then save the coupon.
  </Step>
</Steps>

## Coupon fields reference

| Field                    | Required | Notes                                                |
| ------------------------ | -------- | ---------------------------------------------------- |
| Coupon code              | Yes      | Unique; up to 50 characters                          |
| Description              | No       | Internal reference only                              |
| Discount type            | Yes      | Percent or fixed amount                              |
| Discount value           | Yes      | Percentage number or flat currency amount            |
| Minimum order amount     | No       | Cart must reach this value before the coupon applies |
| Maximum discount amount  | No       | Percent mode only; caps the saving                   |
| Usage limit              | No       | Total redemptions allowed; blank = unlimited         |
| Usage limit per customer | No       | Per-person cap; blank = unlimited                    |
| Valid from               | Yes      | Start of the active window                           |
| Valid to                 | Yes      | End of the active window                             |
| Is active                | Yes      | Toggle to enable or disable                          |
| Applicable order types   | Yes      | Delivery, Pickup, Dine-in (one or more)              |
| Branch                   | No       | Restrict to specific branches; blank = all branches  |

## How customers redeem a coupon

On the storefront, customers add items to their cart and proceed to checkout. Before placing the order they see a **Coupon code** input field. They type the code and the discount is applied immediately, showing the updated total. If the code is invalid, expired, below the minimum order amount, or has reached its usage limit, an error message is shown and the discount is not applied.

<Tip>
  If a customer's order type does not match the coupon's applicable order types (for example, they chose pickup but the coupon is delivery-only), the code will be rejected. Make sure your promotional communications tell customers which order types the coupon covers.
</Tip>

## Coupons vs item promotions

These are two separate features:

* **Coupons** (this page) — customers enter a code at checkout to get money off the order total.
* **Item promotions** — you set a special reduced price on a specific menu item, visible to all customers browsing the menu without needing a code. See [Item Promotions and Specials](/menu/promotions).

## Activating and deactivating coupons

You can toggle any coupon on or off at any time using the **Is active** toggle without deleting it. Inactive coupons are kept in the list so you can reuse or review them later.

<Warning>
  Deleting a coupon is permanent. If you want to retire a code but keep a record of it, deactivate it rather than deleting it.
</Warning>

## Related

* [Item Promotions and Specials](/menu/promotions)
* [How Customers Browse and Order](/online-ordering/storefront-and-checkout)
* [Configuring the Customer Site](/online-ordering/customer-site-settings)
* [Tax, Discount, and Promotion Reports](/reports/tax-discounts-promotions)