This article gives a detailed explanation of every option available in the promotions editor. The options follow the promotions editor from top to bottom, so either scroll down to find what you're looking for or use the search function of your browser.

Name

The name of the promotion that will be displayed inside the POS, the reports and on the receipts. The name must be be between 2 and 45 characters long and is required.

Description

The description field is only visible inside the editor. Here you can add notes about the description to further explain it. The description cannot be more than 5000 characters long.

Restrict to Agents

Here you can select one or more of your agents. When a promotion is restricted to an agent you cannot apply it to orders/customers without that agent.

Billing Code

The billing code allows you to summarize invoices and statements by promotion(s). Use in conjunction with the Summarize by Billing Code setting under Settings > Business Settings > System Settings > Invoice Settings.

Minimum access level require to apply promotion

Here you can select what access level an employee must have to be allowed to apply the promotion to an order or a customer. If no minimum level access is set, the promotion defaults to the Production access level.

Maximum uses per customer

This puts a limit on how many orders for a single customer a promotion can be used. If the limit is reached the promotion the system will give you a warning that the promotion cannot be used any more for that customer.

In case Restrict promotion by time frame is enabled, the use count is only limited within the time frame. When the time frame interval loops around, the use count for the customer is reset.

Maximum discount amount

If this value is defined, an order with this promotion will never receive a total discount larger than this value. For example, if a promotion giving 10% off, with this value is set to $1, is applied to a $20 order, the discount would only be $1 even though 10% off $20 is $2.00.

In case Restrict promotion by time frame is enabled, the maximum discounted value is counted over multiple orders within the time frame instead of only being counted for a single order. When the time frame interval loops around, the discount value count for the customer is reset.

Restrict promotion by time frame

This option allows you to select a time frame, e.g. a date interval, for what order data the "max limit counters" described in this section will use when calculating their values when the promotion is used. Three types of time frames exist:

Note that you need to check the checkbox in order for the dropdown menu to show.

Normally promotions can be applied and used any time. These options allow you to put restrictions on when a promotion can be used.

Only valid through specified dates

With this option enabled the promotion can only be used between the start and end dates selected within the date range picker. You must select both a start date and an end date. Every order created within the time range is eligible to have the promotion applied, even if it happens retroactively.

Note that you need to check the checkbox in order for the date range picker to show.

Only valid during specific dates / times of week

With this option enabled you can select specific weekdays and time slots the promotion can be applied to an order. Every order created within the valid time slots is eligible to have the promotion applied, even if it happens retroactively.

Note that you need to check the checkbox in order for opening hours menu to show.

The coupon options applies when the promotion is selected to be Usable as a coupon and is applied to an order. Read more about promotion types here.

Coupon code

If you define a coupon code the system will generate a barcode that will be associated with this promotion. This barcode can be scanned in order to apply the promotion to an order.

Require scan

If enabled, the promotion can only be applied to an order by scanning the barcode. This mean that you cannot select it in the promotion dropdown list on an order.

Automatically apply when possible

If enabled, the promotion will automatically be applied to all orders matching the Activation Requirements of this promotion (described further down). Note that using this option will likely require you to setting this promotion combinable with your other promotions.

The customer discount options applies when the promotion is selected to be Usable as a customer discount and is applied to a customer account. Read more about promotion types here.

Days valid after attached to customer

If this value is defined, the promotion will only be active on that customer for that many days from the day it was applied to the customer account. After that it will stay on the customer account, but will not give any discount to their orders.

Attach automatically to new customers

If enabled, all newly created customer accounts will have this promotion applied. Use in conjunction with Days valid after attached to customer to create "Get 10% off all your orders first month after signup" types of promotions.

Only valid on first order for new customers

If enabled, this promotion will only be applied to the first order for newly created customer accounts.

Coupon Code

If you define a coupon code the system will generate a barcode that will be associated with this promotion. You can generate links with this barcode/promo code/coupon code or email it to select customers to allow them to apply the promotion to their accounts if Allow customer to set themselves is enabled.

Visible on customer website

If enabled, a customer will be able to see on the customer website that this promotion is attached to their account. They cannot add, remove or modify it.

Allow customer to set themselves

If enabled, a customer will be able to type in the coupon code on the customer website to attach it to their account. They cannot remove or modify it.

Here you can select what other combinations the promotion should be combinable with. By default a promotion is not combinable with any other promotion. See this link for an explanation on how combinable promotions interact.

If a promotion is usable as both a coupon and a customer discount it must be combinable with both the types. The system will check both checkboxes automatically.

Note that you need to click the Show combinations button in order to see the combinations.

The activation requirements are conditions that decide if a promotion can be applied to an order. See this link for an explanation on how that works and how activation requirement overrides work. This section will describe the different options available to you.

You can combine multiple conditions as activation requirements. The conditions are divided into two categories:

To create an activation requirement press the Add requirement button. To add a restriction, press the Add another restriction / Add restriction button within the requirement. To add a sub-requirement, first remove all restrictions from the requirement and then pres the Add requirement button within the requirement.

Restrictions

There are 6 different restrictions. Each of them can only be used once in a single requirement. Combine them within a single requirement create effects like "4 shirts". The restrictions are are:

The discount effects decides how and what items the promotion will affect (rather than if the promotion can be applied to the order at all - that's what the activation requirements does). You can have multiple discount effects on a single promotion, read more about that here.

Include surcharges / alterations

These options decide how the promotion will handle surcharges and alterations, respectively. There are three options:

Note that for a surcharge to be discounted the surcharge itself must the selected to be discountable from the surcharge settings menu.

Effect

This is the monetary effect that will be applied to the orders. This is a required field. There are three types of monetary effects:

You can create a "Free" promotion by setting percentage off to 100%, or by setting a fixed price to $0.

The reason you don't see the option to select items / item sets or total for percentage off is that mathematically this is the same thing.

Maximum amount discounted

If this value is defined, the current discount effect will never yield a discount amount larger than this value. For example, if the effect is 10% off, with this value is set to $1, this will only discount the order by $1 even if the items / items sets has a total price higher than $10.

Note that this only affects the current discount effect. To set a limit on the total discounted amount for the entire order, see Maximum amount discounted described in the Max usage section above.

Maximum number of items / item sets discounted

If this value is defined, the current discount effect will never affect more items than this value. For example, if this value is set to 5, and the order has 6 items that can be discounted, only the first 5 will receive the discount.

Apply discount on

Here you select if your discount effect will affect single items or sets of items (e.g., sets of 2 shirts and 1 pair of pants).

Include items / item sets required for activation

Disabled this option to exclude items that are required to fulfill the activation requirements from being discounted. This can be used to create "Buy 3 pay for 2" or "All shirts after the first 3 are 50% off".

Discount items / item sets matching the criteria below

This is where you select what items / item sets will be discounted by the current discount effect. It has large similarities with the activation requirement structure described earlier.

Single Items

If you have selected that the discount effect will affect single items, the options will look like this:

You can combine multiple conditions to describe what items will be affected. The conditions are divided into two categories:

To create an activation requirement press the Add another requirement / Add requirement button. To add a restriction, press the Add another restriction / Add restriction button within the requirement.

Restrictions

There are 6 different restrictions. Each of them can only be used once in a single requirement. Combine them within a single requirement create effects like "4 shirts". The restrictions are are:

Item Sets

If you have selected that the discount effect will affect item sets, the options will look like this:

The difference is that you, at the top most level in the structure, create item set pieces instead of requirements. Each item set piece will have the same structure/options as a single item and also a numerical value to denote how many of that set piece is required.

In the image above you can see an item set consisting of 2 shirts and 1 pair of pants.