Page tree
Skip to end of metadata
Go to start of metadata



Have you ever ordered pizza online and and been offered garlic bread for $1 when you buy 2 or more pizzas? Well that's essentially how this one works.

You can specify that when a customer orders product X (in the quantity you specify), they can also order product Y at a discounted price, using your promo code.


Please be aware that there are also additional advanced options that you can configure for promotions.  They become available after the promo is created.  You'll find info on these under Advanced Options, later in this article.

Step-by-step guide

  1. In the CMS, navigate to Campaigns & Promotions → Promotion Codes

  2. Click 'Add Promotion Code'.
  3. Set the promotion type to Product
  4. Once the available scenarios are displayed, select the scenario 'When I buy X quantity of specific product then I can buy Y quantity of specific product at a specified price'.

  5. Enter the Promotion Code your customers will use at checkout. 
  6. Enter a Description. This will be displayed in the user's cart and on their order summary. 

  7. Set the promotion's Start and End Dates

  8. Enter the Discount Quantity Threshold. This is the minimum qty of qualifying product your customer must purchase to be eligible for the other, discounted product. (i.e. How many pizzas they have to order). 
  9. Define the Eligible Product (the pizza!), searching by either description or code. (Once you click 'Add', the description will be replaced by the code only).

  10. Define the Special Price Product (the garlic bread!), again searching by description or product code. 

  11. Nominate the Qty and Promotional Price of the Special Price Product (garlic bread) your customer is entitled to buy when they qualify for the promotion.

  12. Decide whether this promo willl Apply In Multiples. That is, if 2 pizzas qualifies your customer for 1 cheap garlic bread, then 4 pizzas will entitle them to 2 cheap garlic breads.

  13. Click Save & Exit to finish creating your promo code.  


And you're done! Start spruiking this great new promo and get ready to sell a LOT of pizza......... and garlic bread.

Advanced options

Each promotion has several advanced options you may wish to configure. These can be accessed immediately after you create the promo, by navigating to OptionsEdit Advanced Options

Or if you're editing an existing promo, they'll be located in a collapsed section below the main promo details:


Misc Options

  • Status - Active / Disabled / Deleted
  • Applied To - B2C / B2B / Both
  • Criteria Fail Remove promo Code - automatically remove the promotion code from the cart when the contents get updated and requirements are no longer met. 
  • Not Applicable With Other Offers - prevents the code from being used on orders where other promotion codes are already applied.
  • Free Product To Be Added in Pronto - (for free product promos only) the free product must be manually added to the sales order once it has integrated to PRONTO. Only note lines containing the Promotion Code and Description will be added to the order if this option is enabled.


Usage Limits

You can set the max number of times the promo code can be used, either by an individual User, users on a particular Customer Code, or Globally (site-wide). Leaving these limits at 0 = unlimited use by all. 

From version 4.10+, you can also specify a user (or comma-separated list of users) who are permitted to use the promotion code. Any user not in this list will be unable to apply the promo to their order.



There are default messages set at the promotion code feature level, but these can be overridden for each individual promotion. Leaving these blank will use the defaults.

  • Promo Code No Longer Applies Message - The notification displayed when the promo code was previously applied, but the user has updated their cart contents such that they are no longer eligible for the promotion.
  • Promotion Code Error Message - The notification displayed when the promo code can't be applied. Perhaps the cart value is not high enough, or the user hasn't purchased the minimum quantity.
  • Promotion Code Applied Message - The notification displayed when the promo code is successfully applied to the user's cart.


Additional Information 

There are also additional advanced options that you can configure for promotions.  They become available after the promo is created. 

Minimum Version Requirements



This article assumes you've already got the Promotion Codes feature enabled for your website. If you haven't, please contact us to switch it on for you.

Self Configurable


Business Function


BPD Only?




Ballpark Hours From CV (if opting for CV to complete self config component)

Contact CV Support

Ballpark Hours From CV (in addition to any self config required)

Contact CV Support

Third Party Costs


CMS Category

Campaigns & Promotions → Promotion Codes