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

# Offers

> Set up discounts and promotions for a shop, using a small set of reusable offer types.

An **Offer** is a discount or promotion applied to a shop's services — first-visit discounts, seasonal sales, referral rewards, and more — each tagged with a reusable **Offer Type**.

<Note>
  You need at least one shop, and the services this offer applies to must already be added, before you can create an offer — see [Shop](/business-module/shop) and [Service](/business-module/service).
</Note>

<Tabs>
  <Tab title="Offer List">
    <Steps>
      <Step title="Open Business → Offers">
        Shows every offer added so far. Use the **Shop**, **Discount Type**, **Status**, **Offer Type**, and **Auto Apply** filters to narrow the list down.
      </Step>

      <Step title="Click + Create Offer and fill in the details">
        | Field                     | Required? | What to enter                                                                       |
        | ------------------------- | --------- | ----------------------------------------------------------------------------------- |
        | **Shop**                  | Yes       | Which shop this offer applies to — pick this first, it unlocks the rest of the form |
        | **Offer Name**            | Yes       | Name shown to customers                                                             |
        | **Description**           | No        | Extra details about the offer                                                       |
        | **Banner Image**          | No        | Promotional image shown with the offer                                              |
        | **Applicable Services**   | No        | Limit the offer to specific services from this shop; leave empty to apply to all    |
        | **Discount Type**         | Yes       | Percentage or a fixed amount off                                                    |
        | **Discount Value**        | Yes       | A percentage (1–100) or a fixed amount, depending on Discount Type                  |
        | **Start Date / End Date** | Yes       | How long the offer runs                                                             |
        | **Start Time / End Time** | No        | Daily time window the offer is valid, e.g. 10:00–18:00                              |
        | **Wallet Reward**         | No        | Give the discount as wallet credit instead of an instant price cut                  |
        | **Offer Type**            | Yes       | Pick a reusable type — see Manage Offer Types below                                 |
        | **Max Discount Cap**      | No        | Caps the discount amount; only applies to a Percentage discount                     |
        | **Min Order Value**       | Depends   | Required for a fixed-amount discount, and must be at least the discount value       |
        | **Auto Apply**            | No        | Apply automatically at billing, without the customer needing a code                 |
        | **First Order Only**      | No        | Restrict the offer to a customer's first order                                      |
        | **Max Per User**          | No        | How many times one customer can redeem this offer                                   |
        | **Total Max Redemptions** | No        | Overall redemption limit across all customers; leave blank for unlimited            |

        Save to create the offer.
      </Step>
    </Steps>

    <Warning>
      Offers can be edited any time, including while active — changes apply immediately to a live offer. There's no way to delete an offer from here; to stop one, open it and switch its status to Inactive instead.
    </Warning>

    ### Manage Offer Types

    Offer Types are a small reusable list (e.g. First Visit, Seasonal, Referral, Flash) used to tag offers. Five default types come pre-set and can't be edited or removed — you can only add new ones.

    <Steps>
      <Step title="Click Manage Types, then fill in the name">
        | Field               | Required? | What to enter                                                                                 |
        | ------------------- | --------- | --------------------------------------------------------------------------------------------- |
        | **Offer Type Name** | Yes       | A short label, e.g. "Seasonal Offer" — automatically formatted in caps, e.g. `SEASONAL_OFFER` |

        Save to add it to the list — it's now available to pick when creating an offer.
      </Step>
    </Steps>

    <Warning>
      Deleting a custom offer type can't be undone.
    </Warning>
  </Tab>

  <Tab title="Usage Analytics">
    <Steps>
      <Step title="Click the Usage Analytics tab">
        Use the **Offer**, **Shop**, and **Customer** filters, with **Reset** / **Apply**, to focus on a specific offer, shop, or customer.
      </Step>
    </Steps>

    The summary cards show Redemptions, Gross Amount, Total Savings, Revenue (Net), Avg. Savings, and Avg. Order Value.

    The **Usage by Offer** chart shows how many times each offer has been redeemed — there's no date-range filter here, unlike Inventory Management's usage chart.

    Below that, the **Detailed Usage Log** lists every redemption: date, offer, customer, original amount, discount, final amount paid, and status (Used / Pending).

    **Quick View** gives two actions per redemption, each disabled if that redemption isn't linked to one:

    * <Icon icon="arrow-right-left" /> **Transaction Details** — opens the transaction this redemption was part of
    * <Icon icon="calendar" /> **Appointment Details** — opens the appointment it happened in (read-only)
  </Tab>
</Tabs>
