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

# Start here

> Promotions are a powerful tool to increase conversion rates, increase average order value, and clear inventory. Your Promotions Dashboard allows you to create, track, and manage these offers in real-time.

## Types of Promotions

Local Pass supports four types of storefront promotions, all managed from your Promotions dashboard.

<Columns cols={2}>
  <Card title="Discount on Products" icon="tag">
    **Mechanism:** A percentage or dollar discount on specific products you choose.

    * **Best for:** Highlighting particular items — a new dish, a slow-moving product, a seasonal favorite. Can also make an item entirely free.
    * **Customer Experience:** The item shows its original price crossed out with the sale price highlighted, right on your storefront.
    * **Different from a promotion:** this behaves like a live sale price — there's no "redemption" to track, so it can't be limited to one use per customer.
  </Card>

  <Card title="Buy X Get Y" icon="gift">
    **Mechanism:** Discount or give away a reward item when a customer buys a qualifying item (e.g., "Buy a Burger, get a Drink 50% off" or "Buy one Pizza, get one free").

    * **Best for:** Launching a new product, or clearing inventory by bundling it with a best-seller.
    * **Customer Experience:** Once a customer's cart has what's needed on the "Buy" side, they're offered the "Get" reward.
    * **What you can pick:** Both the "Buy" and "Get" side can be one or more specific products, one or more categories, or "Any product" — it's not limited to a single item.
  </Card>
</Columns>

<Columns cols={2}>
  <Card title="Amount off Order" icon="sparkles">
    **Mechanism:** A percentage or flat discount off the entire order once it meets your rules (e.g., "Spend \$30, save \$5").

    * **Best for:** Increasing average order size — set the minimum just above your typical basket to nudge a customer to add one more item.
    * **Customer Experience:** Applies automatically at checkout once the cart qualifies.

    <Warning>
      **A percentage discount here only works in the Local Pass app — not on localpass.ca.** If you want a promotion that works everywhere, including the website, use a **fixed dollar amount** instead.
    </Warning>
  </Card>

  <Card title="Free Shipping" icon="truck">
    **Mechanism:** Waives the shipping cost on a qualifying order.

    <Warning>
      **Not available for restaurants, and not usable yet anywhere else.** No checkout — in the app or on the website — currently applies a free-shipping promotion. Hold off creating one until this is confirmed working; existing ones can still be edited.
    </Warning>
  </Card>
</Columns>

## Discounts Beyond the Promotions Manager

Two related tools live outside the main Promotions list, for quicker one-off changes:

<Columns cols={2}>
  <Card title="Individual Product Sale" icon="tags">
    Set a **Sale Price** directly on a product's own page (see [Create or Edit Product](/create-product)), separate from any Promotions Manager rule.

    * **Best for:** A quick markdown on one item without setting up a full promotion.
    * **Customer Experience:** Shows the regular price crossed out with the sale price next to it.
  </Card>

  <Card title="Soon-to-Go" icon="clock">
    Mark specific items as **Soon-to-Go** from Menu Management or the product editor, then pick a discount from a quick calculator (10%, 20%, 30%, or 50% off).

    * **Best for:** Clearing perishable inventory before it expires and reducing food waste.
    * These items also get a badge and boosted visibility in "Rescue"/eco-friendly sections of the marketplace.
  </Card>
</Columns>

<Warning>
  **Stacking:** individual product discounts (Sale Price, Soon-to-Go) apply **in addition to** any order-level promotion that's also active. A customer buying a marked-down item can also trigger a "Spend \$20, get \$5 off" promotion on top of it — plan your numbers with that in mind.
</Warning>

## How Promotions Apply

All four promotion types apply **automatically** — a customer never has to enter a code. Once their cart meets your rules, the discount shows up on its own.

Every promotion also supports:

* **A minimum requirement** — choose one: no minimum, a minimum quantity of items, or a minimum dollar amount, before the promotion kicks in.
* **A schedule** — restrict the promotion to specific days of the week and hours of the day (e.g., only weekday lunch).
* **Limit to one use per customer** — stop the same person from redeeming it more than once.

<Warning>
  **A promotion can't be combined with another promotion.** Only one Promotions Manager promotion applies to a customer's order at a time — if you need two offers to potentially stack, one of them should be an Individual Product Sale or Soon-to-Go markdown instead (see below), not a second promotion.
</Warning>

<Warning>
  **On Buy X Get Y and Discount on Products, you must select at least one product or category** for any side that isn't set to "Any product" — the app won't let you save a promotion with an empty reward. If you want the promotion to apply broadly, choose "Any product" instead of leaving the picker empty.
</Warning>

## Creating a Promotion

1. Navigate to the **Promotions** tab in your dashboard.
2. Click the **"Create promotion +"** button in the top right corner.
3. Select your promotion type and configure the rules — see [Add new promotion](/restaurants/promotions-manager/add-new-promotion) for a full walkthrough of every field.
4. **Dates:** Set a **Start Date** and, optionally, an **End Date** to schedule campaigns in advance.

## Managing Promotions

Your dashboard gives you a comprehensive view of all campaigns.

### Featured Promotions

The top section of the page displays a carousel of your **Featured Promotions**. These are typically high-priority offers that are highlighted on your storefront.

* **Green Card:** Active promotion currently live to customers.
* **Gray/Neutral Card:** Draft promotion (not yet visible).

### All Promotions List

Below the featured section is a detailed data table of every promotion you have created.

* **Status:** Quickly see if a promo is **Active** or **Draft**.
* **Used:** This column tracks the number of times customers have successfully redeemed the offer, helping you measure ROI.

<Note>
  **There's currently no "pause" button.** To take a live promotion offline, save it back to **Draft**, or edit its End Date. Deleting a promotion removes it permanently — there's no way to bring it back once it's gone.
</Note>

## Troubleshooting

| Issue                                                             | What's happening                                                                                                                                                                                         |
| :---------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **My promotion shows "Inactive" even though I just published it** | Open the promotion in **Edit** and check its Status there directly — that's the source of truth. If it says Active, customers can already redeem it, even if a list view elsewhere hasn't caught up yet. |
| **I can't save my Buy X Get Y or Discount on Products promotion** | You've likely left a required side of the picker empty. Add at least one product or category, or switch that side to "Any product."                                                                      |
| **My percentage discount isn't showing up on the website**        | Percentage-based "Amount off Order" promotions only apply in the Local Pass app right now. Switch to a fixed dollar amount if you need the promotion to also work on localpass.ca.                       |