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

# Promotions

> Run auto-applied promotions that activate at checkout without a code. Configure trigger conditions and roll out seamless offers to every eligible customer.

Promotions are discounts that apply automatically at checkout without customers needing to enter a code. They're perfect for seamless offers that you want every eligible customer to receive.

<Note>
  Promotions require storekit+
</Note>

## How Promotions Work

Unlike discount codes, promotions:

* Apply automatically when conditions are met
* Don't require customers to know or enter a code
* Show the discount applied in the cart automatically
* Can target specific products or categories

## Creating a Promotion

1. Go to **Discounts** in the sidebar
2. Click **Add Discount**
3. Configure your discount type and value
4. Toggle **Auto-apply** on
5. Set your targeting and restrictions
6. Click **Save**

## Targeting Options

### All Products

The promotion applies to the entire order. Use for site-wide sales.

### Specific Categories

Target products in selected categories only. Useful for:

* "20% off all desserts"
* "Free starter with any main"

### Specific Products

Target individual products. Useful for:

* Highlighting slow-moving items
* New product launches
* Loss leaders to drive traffic

## Use Cases

### Happy Hour

Create a time-limited promotion:

* 20% off drinks
* Available 4pm-7pm
* Weekdays only

### Lunch Special

Encourage midday orders:

* £2 off orders over £10
* Available 11am-2pm

### Weekend Deals

Boost weekend sales:

* 15% off all orders
* Saturday and Sunday only

### Category Promotion

Promote specific menu sections:

* 25% off starters
* Encourages add-on purchases

### New Item Launch

Draw attention to new products:

* 50% off new burger
* Limited time only

## Promotion vs Discount Code

| Feature                  | Promotion                        | Discount Code                        |
| ------------------------ | -------------------------------- | ------------------------------------ |
| Customer action required | None                             | Enter code                           |
| Visibility               | Automatic in cart                | Must know code                       |
| Best for                 | Site-wide offers, category deals | Targeted campaigns, influencer codes |
| Exclusivity              | Available to everyone            | Only those with the code             |

## Stacking

By default, only one discount applies per order. If multiple promotions are eligible, the one providing the greatest value to the customer is applied.

<Tip>
  Use discount codes for exclusive offers (influencer partnerships, email subscribers) and promotions for offers you want everyone to see.
</Tip>

## Managing Promotions

### Priority

When multiple promotions could apply, storekit automatically selects the best one for the customer. You don't need to set priority manually.

### Pausing a Promotion

Toggle the promotion off to temporarily disable it. This is useful for:

* Seasonal promotions between seasons
* Promotions you want to reuse later

### Scheduling

Set start and end dates to automatically activate and deactivate promotions. Plan your promotional calendar in advance.

## Tips

* **Clear naming** - Name promotions descriptively (e.g., "Summer 2024 - 20% off desserts")
* **Set end dates** - Avoid promotions running indefinitely
* **Monitor margins** - Track the cost of promotions against increased sales
* **Combine with marketing** - Promote your offers on social media and in-store
* **Test first** - Place a test order to verify the promotion applies correctly

## Troubleshooting

<AccordionGroup>
  <Accordion title="Promotion not applying at checkout">
    Work through this checklist:

    1. **Is the promotion toggled ON?** — Check the promotion status in Discounts.
    2. **Does the order meet the minimum spend?** — The subtotal must reach the threshold before the discount applies.
    3. **Is the promotion within its scheduled dates?** — Verify the start and end dates haven't passed or aren't in the future.
    4. **Does the order contain items from the targeted categories/products?** — If targeting is set, only matching items trigger the promotion.
    5. **Is another discount already applied?** — Stacking is disabled by default; only one discount applies per order.
  </Accordion>

  <Accordion title="Promotion shows for wrong items">
    Check your category or product targeting settings. If the promotion targets a category, any item added to that category is automatically included — even newly added items. To exclude specific products, switch to product-level targeting instead.
  </Accordion>

  <Accordion title="Promotion expired but still showing">
    Clear your browser cache and refresh the page. If the promotion still appears, verify that the end date is set correctly and accounts for your timezone — times are interpreted in your venue's configured timezone.
  </Accordion>
</AccordionGroup>