Creating and Configuring Promotions
Step-by-step guide to create and configure promotions in Sarah.
Last updated: 2026-11-17
This guide will teach you how to create and configure promotions in Sarah step by step.
Access to Promotions
- Navigate to Promotions in the main menu
- Click "New Promotion" or the add button
Basic Fields
Name
A descriptive name to easily identify the promotion.
Examples:
- "2x1 on Beverages"
- "20% OFF on Clothing"
- "Burger Combo"
Barcode (optional)
You can assign a barcode to the promotion and scan it at the POS.
- For a bundle or promos with product-only targets, scanning loads those products into the cart (each scan adds another full set).
- If targets are category, brand, or all, the code can still be saved but POS will say it cannot assemble automatically.
- The code must not match a product barcode or another promo in the same company (the form flags it and blocks save).
Discount code (optional, online store only)
You can turn the promotion into a code that the buyer types in the cart.
- When a code is set, the promotion stops applying automatically and becomes online-store only: POS never applies it.
- The buyer enters it in the cart; Sarah validates the code on the server, shows the savings and stores it with the sale.
- Up to 40 characters: letters, numbers, dot, hyphen or underscore. Case-insensitive.
- Leave it empty and the promotion works as before (automatic, according to the selected channel).
- The channel is locked to Online store only while a code is present.
- If two active promotions share the same code, the one with the highest priority wins.
Promotion Type
Select one of the four available types:
- Buy X Get Y
- Discount on Nth
- Percentage Discount
- Fixed Price for Combos
Priority
Number that determines the order of application when there are multiple promotions.
- Higher number = Higher priority
- If two promotions can apply, the one with higher priority is evaluated first
Recommendation: Use numbers like 10, 20, 30 to leave space between priorities.
Active
Checkbox to enable or disable the promotion without deleting it.
Stackable
If checked, this promotion can be combined with other stackable promotions.
If unchecked, this promotion has exclusive priority and can block other promotions.
Configuration by Type
Buy X Get Y
Required fields:
- X: Quantity of products customer must buy
- Y: Quantity of products they get free
Example:
X: 2
Y: 1
Result: Buy 2, get 1 free (2x1)
Discount on Nth
Required fields:
- N: Product position (2 = second, 3 = third, etc.)
- Discount: Percentage discount to apply
Example:
N: 3
Discount: 50%
Result: 3rd product has 50% discount
Percentage Discount
Required fields:
- Percentage: Discount to apply (0-100)
Example:
Percentage: 20
Result: 20% discount on eligible products
Fixed Price for Combos
Required fields:
- Products: List of combo slots (each with a quantity)
- Fixed Price: Total combo price
On each slot you can pick one product (fixed) or several (mix and match: any counts toward that quantity).
Example:
Slot 1: Burger × 1
Slot 2: Fries × 1
Slot 3: Drink A or Drink B × 1
Fixed Price: 1500
Result: Completing all 3 slots costs $1500
Target Configuration
Targets define which products the promotion applies to.
Add Targets
- Click "Add Target"
- Select target type:
- All: Applies to any product
- Product: Select a specific product
- Category: Select a category
- Brand: Enter brand name
Multiple Targets
You can add multiple targets. The promotion applies if the product matches any of the targets (OR logic).
Example:
- Target 1: Category "Beverages"
- Target 2: Brand "Premium"
- Result: Applies to beverages OR Premium brand products
Validity Dates
Start Date
Date and time when the promotion begins to be active.
If not specified, the promotion is active from its creation.
End Date
Date and time when the promotion stops being active.
If not specified, the promotion doesn't expire.
Sales Channel
Optionally, you can limit the promotion to a specific channel:
- POS: Only at point of sale
- Online Store: Only on the web store
- All: In all channels
Stores
If the company has more than one store, you can limit the promotion to one or more locales (by store number).
- Empty / all stores: applies at every branch (previous behavior).
- Selected stores: applies only at the POS for those stores' open shifts. It does not apply in the online shop (the shop is not tied to a store).
Complete Example: 2x1 Beverages Promotion
- Name: "2x1 on Beverages - Summer 2025"
- Type: Buy X Get Y
- Configuration:
- X: 2
- Y: 1
- Targets:
- Category: "Beverages"
- Priority: 10
- Stackable: No (unchecked)
- Active: Yes
- Dates:
- Start: 2025-01-01 00:00
- End: 2025-03-31 23:59
- Channel: All
- Stores: All (or pick specific branches)
Validation and Saving
Before saving, verify:
- ✅ All required fields are complete
- ✅ Numeric values are valid (X > 0, Y >= 0, percentages between 0-100)
- ✅ At least one target is configured
- ✅ Start and end dates are coherent
Click "Save" to create the promotion.
Edit Promotions
To edit an existing promotion:
- Go to the promotions list
- Click the promotion you want to edit
- Modify necessary fields
- Save changes
Note: Changes apply immediately to new sales.
Delete Promotions
- Select the promotion
- Click "Delete"
- Confirm deletion
Warning: Deleted promotions cannot be recovered.
Next Steps
- Stackable Promotions - Learn to combine promotions
- Promotion Types - Review details of each type