Eligibility rules add cart-level conditions on top of a promo code's discount. The code is only valid when the customer's cart meets the rule's requirements. Use them to gate a discount behind a minimum group size, run a "Buy X Get Y" deal, or build any promotion that needs more than a flat percentage off.
Getting started
Open or create a promo code in Purchases > Promo codes. Scroll to the Eligibility rules section near the bottom of the form. Click Add rule to add a new rule.
How it works
Rules are conditions attached to a promo code. Multiple rules can stack on a single code, and all of them must be satisfied for the discount to apply. Two rule types are available.
| Rule type | What it does |
|---|---|
| Quantity rule | Gates the discount on the cart's participant or item count. Choose Minimum (at least N), Maximum (no more than N), or Range (between N and M) |
| Buy X Get Y Rule | Requires a specific qualifying purchase ("buy X") and discounts another set of items ("get Y") at a percentage, fixed amount, or free |
The promo code's own Amount and a Buy X Get Y rule's reward stack by default. To run a rule-only deal (e.g., a true "Buy 2 Get 1 Free" without an additional baseline percent off), set the promo code's Amount to 0. An alert in the form reminds you of this when at least one Buy X Get Y rule exists: This discount applies in addition to Buy X Get Y rules. Set amount to 0 for rule-based discount only.
Step-by-step guide
Add a rule
In the Eligibility rules section of the promo code form, click Add rule. A rule-type picker opens with the heading Select rule type: and clickable cards for each available rule type.
| Card | Rule key | What it gates |
|---|---|---|
| Quantity rule | MIN_QUANTITY | Cart-quantity threshold (Minimum, Maximum, or Range) |
| Buy X Get Y Rule | BUY_X_GET_Y | Purchase-driven reward |
Click a card to open the rule's configuration modal, or click Cancel to back out without adding.
Configure a Quantity rule
Pick the Quantity rule card. The rule modal opens with the Quantity requirements section. The modal title and description adapt to the mode you pick.
1. Pick a requirement type
| Mode | Modal title | What it requires |
|---|---|---|
| Minimum | "Minimum quantity" | The cart has at least N participants or items |
| Maximum | "Maximum quantity" | The cart has no more than N participants or items |
| Range | "Quantity range" | The cart has between N and M participants or items |
The Requirement type segmented pill toggle at the top of the modal switches between the three. Switching modes preserves whichever value applies (the Minimum quantity field stays visible for Minimum and Range; the Maximum quantity field stays visible for Maximum and Range).
2. Enter the quantity
| Field | Shown for | Notes |
|---|---|---|
| Minimum quantity | Minimum, Range | Numeric input. Min 1, max 999 (capped at the Maximum quantity when in Range mode) |
| Maximum quantity | Maximum, Range | Numeric input. Max 999 (in Range mode, the minimum is forced to be at least the Minimum quantity) |
3. Pick what the rule counts
The Applies to dropdown controls what the rule's numbers count.
| Option | What it counts |
|---|---|
| Total participants (for bookings) | Group size summed across every booking in the cart |
| Line items in cart | Total items in the cart, summed by quantity |
| Unique items (different products) | Count of distinct products in the cart, ignoring quantity |
Total participants is the common case.
When Applies to is Total participants, a contextual hint appears underneath. The hint text adapts to the promo code's Value type, and the words "this minimum" change to "these limits" when Maximum or Range is selected.
| Value type | Hint (Minimum mode wording shown) |
|---|---|
| Per transaction | "Per transaction: The total participants across all bookings in the cart must fall within these limits. If the cart qualifies, all bookings receive the discount." |
| Per line item | "Per line item: Each booking is evaluated individually. Only bookings whose participant count falls within these limits will receive the discount." |
| Per quantity | "Per quantity: The total participants across all bookings must fall within these limits. Discount applies per participant." |
4. Save
Click Add rule at the bottom to commit the new rule, or Cancel to discard. When editing an existing rule the button reads Update rule.
Rule card summary
The configured rule's card on the form summarizes the rule in plain language:
| Mode | Summary format |
|---|---|
| Minimum | "Minimum N participants required" (or "line items" / "unique items") |
| Maximum | "Maximum N participants allowed" |
| Range | "Between N and M participants required" |
Configure a Buy X Get Y Rule
Pick the Buy X Get Y Rule card. The rule modal opens with the title Buy X Get Y Rule rule and two sections.
Required purchase (Buy X)
| Field | Notes |
|---|---|
| What customer must buy | Dropdown with: Games/experiences, Merchandise, Gift cards, Any item type |
| How many they must buy | Numeric input. Min 1, max 999 |
| Limit to specific [type] | Toggle. Renders when the picker isn't Any item type. Off by default |
| Select [type] | Multi-select of items in that category. Only renders when the toggle is on |
| If multiple items selected | Radio: Any (at least one item from the list) or All (every item from the list). Only renders when more than one item is selected |
Discount reward (Get Y)
| Field | Notes |
|---|---|
| What gets discounted | Dropdown with: Games/experiences, Merchandise, Gift cards |
| Which [type] | Multi-select of items that receive the discount. At least one item is required |
| Discount type | Dropdown: Free, Percentage off, or Fixed amount off |
| Percent off / Amount off ($) | Numeric input. Renders when discount type is Percentage or Fixed amount. Hidden for Free |
| Max items to discount | Numeric input. Caps how many items the discount applies to per order. Min 1, max 99 |
When the same item appears in both Limit to specific (Buy X) and Which (Get Y), an overlap warning appears: Some items appear in both sections. Make sure this is intentional (e.g., "Buy 2, get 1 free" on same item).
Validation messages appear inline next to fields that need attention.
| Validation | When |
|---|---|
| Select at least one item to discount | Get Y items list is empty after touching |
| Must be greater than 0 | Discount value is 0 or less |
| Cannot exceed 100% | Percentage value is greater than 100 |
Click Add rule to commit, or Cancel to discard. Editing reads Update rule instead.
Edit a rule
In the configured rules grid on the form, click the pencil (edit) icon on the rule's card. The rule modal opens prefilled with the current configuration. Update fields and click Update rule to save.
Delete a rule
Click the trash icon on the rule's card. The rule is removed from the promo code's rules list. There's no separate save step — the rule is gone as soon as you click. Save the promo code to persist.
Add multiple rules
You can attach as many rules as you need to a single promo code. Click Add rule again after configuring the first. All rules must be satisfied for the discount to apply.
Reference
Add rule flow
| Step | Element |
|---|---|
| 1 | Add rule button in the Eligibility rules section |
| 2 | Rule-type picker with heading "Select rule type:" |
| 3 | Cards: Quantity rule and Buy X Get Y Rule |
| 4 | Rule modal opens with the rule-specific form |
| 5 | Add rule (new) or Update rule (edit) at the bottom |
Configured rule card
| Element | What it shows |
|---|---|
| Badge | Rule type (info-style badge with the rule name) |
| Edit icon | Pencil icon, opens the rule modal in edit mode |
| Delete icon | Trash icon, removes the rule immediately |
| Body | Auto-generated summary of the rule's configuration |
Quantity rule
| Field | Type | Bounds |
|---|---|---|
| Requirement type | Segmented pill | Minimum / Maximum / Range |
| Minimum quantity | Numeric | 1–999. Shown for Minimum and Range modes |
| Maximum quantity | Numeric | 1–999, at least the Minimum quantity when in Range mode. Shown for Maximum and Range modes |
| Applies to | Dropdown | Total participants / Line items in cart / Unique items |
Modal title and description by mode
| Mode | Modal title | Modal description |
|---|---|---|
| Minimum | Minimum quantity | Require a minimum number of participants or items in the cart |
| Maximum | Maximum quantity | Require a maximum number of participants or items in the cart |
| Range | Quantity range | Require the number of participants or items to fall within a range |
Buy X Get Y Rule — Required purchase
| Field | Notes |
|---|---|
| What customer must buy | Games/experiences / Merchandise / Gift cards / Any item type |
| How many they must buy | Numeric, 1–999 |
| Limit to specific [type] | Toggle, only when type is not "Any item type" |
| Select [type] | Multi-select, only when toggle is on |
| If multiple items selected | Any / All radio, only when more than one item is picked |
Buy X Get Y Rule — Discount reward
| Field | Notes |
|---|---|
| What gets discounted | Games/experiences / Merchandise / Gift cards |
| Which [type] | Multi-select, at least one required |
| Discount type | Free / Percentage off / Fixed amount off |
| Percent off | Numeric, 1–100, precision 0. Only for Percentage off |
| Amount off ($) | Numeric, 1–99999, precision 2. Only for Fixed amount off |
| Max items to discount | Numeric, 1–99 |
Validation messages
| Message | When |
|---|---|
| Select at least one item to discount | Get Y items is empty |
| Must be greater than 0 | Discount value is zero or negative |
| Cannot exceed 100% | Percentage value exceeds 100 |
Overlap warning
| Trigger | Copy |
|---|---|
| Same item appears in Limit to specific (Buy X) and Which (Get Y) | "Some items appear in both sections. Make sure this is intentional (e.g., \"Buy 2, get 1 free\" on same item)." |
Combination behavior alert (on the promo code form)
| Trigger | Copy |
|---|---|
| Promo code has at least one Buy X Get Y rule | "This discount applies in addition to Buy X Get Y rules. Set amount to 0 for rule-based discount only." |
Good to know
- All rules must pass. Multiple rules act as an AND, not an OR. A code with both a Quantity rule and a Buy X Get Y rule needs both conditions met before the discount kicks in.
- One Quantity rule, three modes. Minimum, Maximum, and Range are all the same rule under the hood — switching the Requirement type updates the visible fields and the rule's plain-language summary. You don't add three separate rules.
- Range needs both numbers. Forgetting one of the two values defaults it to whatever the other field provides; the form steers you so the Maximum quantity can't drop below the Minimum quantity.
- Existing Minimum-only rules are unchanged. They open in Minimum mode and behave exactly as before. You only get the Maximum or Range behavior when you switch the Requirement type.
- Gift cards are never gated by Quantity rules. Gift card line items don't count toward the rule's quantity and aren't blocked by it either.
- The calendar booking drawer applies the rule immediately. When a staff member adds the code to a booking, the requirement is checked on the spot. If the booking doesn't qualify the code is blocked and the reason is shown. If the participant count is later changed so an already-applied code no longer qualifies, the code is removed automatically and a notice appears.
- In the calendar drawer, the immediate check is exact for Total participants only. For Line items in cart and Unique items, the drawer's check assumes a single booking, since the drawer doesn't yet support multi-line carts. The final amounts are always re-validated on save.
- The promo code's Amount stacks with rule rewards. Set the Amount to 0 if you want the rule alone to drive the discount (e.g., a "Buy 2 Get 1 Free" without an additional baseline percent off).
- Buy X Get Y on the same item is a valid configuration. The overlap warning is informational, not blocking. Use it for "Buy 2 of X, get 1 of X free" promotions.
- Max items to discount caps the reward. For "Buy 2 Get 1 Free", set Max items to discount to 1 so a customer buying 4 doesn't get 2 free.
- Free discount type removes the price entirely from the matching items. Use it for "Buy a card, get a t-shirt free" or any zero-cost reward.
- Percentage off and Fixed amount off apply to each matching item individually, capped by Max items to discount.
- Eligibility rules are per-code, not per-group. Promo code groups can pre-fill many fields but not eligibility rules; configure them on each code that needs them.
- Rules are deleted instantly when you click the trash icon on the rule card. There's no undo within the form, but until you save the promo code itself, you can navigate away to discard the change.
- The cart evaluates rules at apply time. If the cart contents change after the code is applied, the rules re-evaluate and the discount may drop or shift.
FAQ
Q: Can I create a "Buy 2, Get 1 free" deal on the same item?
A: Yes. Add a Buy X Get Y Rule. In the Required purchase, pick the item type, set How many they must buy to 2, toggle Limit to specific [type] on, and pick the item. In the Discount reward, pick the same item type, pick the same item, set Discount type to Free, and Max items to discount to 1. The overlap warning is expected for this configuration.
Q: How do I make a "10% off groups of 8 or more" promo?
A: Set the promo code's Redemption type to Percentage discount and Amount to 10. Add a Quantity rule with Requirement type = Minimum, Minimum quantity = 8, and Applies to = Total participants.
Q: How do I make a "10% off, small groups only (up to 4 people)" promo?
A: Set the promo code's Redemption type to Percentage discount and Amount to 10. Add a Quantity rule with Requirement type = Maximum, Maximum quantity = 4, and Applies to = Total participants. Larger groups will see the code rejected at checkout.
Q: How do I make a promo valid only for groups of 6 to 10 people?
A: Add a Quantity rule with Requirement type = Range, Minimum quantity = 6, Maximum quantity = 10, and Applies to = Total participants. Groups outside that range can't apply the code.
Q: Can I add multiple rules to one promo code?
A: Yes. Click Add rule again after the first rule is saved. All attached rules must be satisfied for the code to apply.
Q: Why does my discount apply twice when using a Buy X Get Y rule?
A: Because the promo code's Amount field stacks with the Buy X Get Y reward by default. To run a rule-only deal, set the promo code's Amount to 0.
Q: Why is the "If multiple items selected" Any/All field hidden on my rule?
A: It only appears once you've selected more than one item in the Limit to specific [type] multi-select. With one item picked, the toggle isn't relevant.
Q: Can I configure eligibility rules in bulk via Bulk actions?
A: No. Bulk actions on the Promo codes page don't include eligibility rules. Configure them per-code from the create or edit form.
Q: What's the difference between "Line items in cart" and "Unique items" in the Quantity rule?
A: Line items in cart sums up the quantity of every line (a cart with 2 of item A and 3 of item B counts as 5). Unique items counts distinct products only (the same cart counts as 2). Use unique items for "buy 3 different products, get a discount" promotions.
Q: A staff member added a code to a booking but the participant count just changed and the code disappeared. Why?
A: The Quantity rule re-validates whenever the booking changes. If the new participant count no longer satisfies the rule (e.g., dropped below the Minimum, exceeded the Maximum, or moved outside the Range), the calendar drawer auto-removes the code and shows a notice. Re-apply the code if the booking comes back into range, or pick a different code that does qualify.
Q: My Buy X Get Y rule is configured but customers say the discount isn't applying. What should I check?
A: First confirm the customer's cart actually contains items matching both the Buy X side (with the right quantity) and the Get Y side. Also confirm the promo code itself is valid (within date range, on an allowed day, scoped correctly). Test by applying the code in your own checkout to reproduce.