Skip to end of metadata
Go to start of metadata


Product Discount promotion codes give your customers a percentage or amount discount on an individual product or group of products. Rather than applying a discount to the entire order, only specific products attract the discount, once the user meets the purchase criteria that you set.

Scenarios available:

  • When I buy X quantity of specific product, then I can buy Y quantity of specific product at a specified price: e.g., buy 5 of product X at this set discount price
  • Quantity Break Pricing: e.g., buy 5 or more of X and get a discounted price on each
  • I can buy X quantity of eligible products for a set price: e.g., buy 5 products from this product range and get a set discount price
  • When I buy X quantity of eligible products, then I can buy Y quantity of specific products at a percent discount: e.g., buy 5 from this product range and get 2 products from another range at 20% off
  • When I buy X quantity of specific products, then I get a Y% discount on those products: e.g., buy 5 from this product range and get 20% off on them
  • When I buy X quantity of eligible products, I get Y% discount on Z additional quantity: e.g., buy 5 from this product range and get 20% discount off any quantity over the 5. 
  • When I buy X quantity of specific products, then I get a Y% discount on those products: e.g., buy 5 from this product range and get 20% off


Regardless of which promo code you use, the fields have a standard look-and-feel and consistent logic to them. Once you can create one, you can create any others. We will use an example as a guide. We'll create a promo code for '20% off sleeping bags when you buy at least 4'.

Step-by-step guide

  1. In the CMS, navigate to Campaigns & PromotionsPromotion Codes.

  2. Click Add Promotion Code.

  3. Select Promotion Type = Product.

  4. Next, decide whether your customer needs to buy a certain quantity, or spend a certain dollar amount to qualify for the discount. 
    Select your scenario accordingly (we'll base ours on quantity).

  5. Enter the Promotion Code (no spaces). This is what your customer enters at checkout to redeem the promo.

  6. Give the promotion a description. This will be displayed in the user's order summary during checkout.

  7. Specify Start and End dates. Click the calendar icon to launch the date picker. 

  8. Enter the Discount Threshold. This is the quantity the customer must buy (or dollar amount they must spend) to qualify for the discount.

  9. Enter the Discount %. This is the discount the customer will receive on the specified products.
    Note that for B2B scenarios, any customer-based discounts will still be honoured; this discount will be on top of that.

  10. Click Add and specify the products for this promo. You can specify by:
    • Product - add individual stock code(s)

    • Stock Group - all products belonging to a particular ERP stock group

    • Category - all products in a particular category

  11. Click Add again to specify more products if required.

  12. Save & Exit.

Your product discount promo is now ready to go!

Advanced options

Each promotion code 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 code, they'll be located in a collapsed section below the main promo details:

Misc Options

  • Status - 'Active': the promo code is live on your site and can be used by customers
    'Disabled': the promo code cannot be used by customers but can be switched to 'Active'
    'Deleted': the promo code is deleted from use altogether and is kept for historical records only. (NOTE - A deleted promo code can be undeleted to 'disabled' and then reactivated.) 
  • Applied To - B2C / B2B / Both
  • Criteria Fail Remove promo Code - ON: the system automatically removes the promotion code from the cart when the contents get updated and requirements are no longer met. Users will have to re-enter the promo code if they want the code to be applied; OFF: the promo code is still in cart and if contents get updated and requirements are met, it will be (re-)applied. 
  • Not Applicable With Other Offers - ON: limits the promotion code from being used when other promotion codes are already applied to the order; OFF: promo code will be applied when other promo codes have been applied to the order. 
  • Free Product To Be Added in Pronto - (applies only for Promo Codes that add a free product).

    For Promo Codes where a free product is given, you have the option of adding the free product on your website when the order is submitted or in the ERP (Pronto) when the order is integrated. Select the option you require by toggling 'Free Product To Be Added in Pronto' ON or OFF. Default: OFF

    Order placed, received and confirmation emails will display the free product differently depending on the option selected. 

    • If toggled OFF, the free product is added on your website. In emails to the customer about the order, the free product appears as an item with a cost of $0.00 in the product line of your Order Summary
    • If toggled ON, the free product is added in the ERP. When you toggle ON the option, you will be asked to confirm you want the free product added in the ERP. Clicking Confirm enables the ERP option.

      Note - Scroll back up to the 'Free Product' fields. The fields are now empty and disabled. The free products you previously added for this promo code still apply.  

      The Order Placed, Received and Confirmation emails by default will not display the free product separately in the Order Summary. 
      To add a note line about the free product in the Order Summary section, toggle on the 'Show Note Lines on Individual Lines?' option in the Email Order Summary widget in any applicable email template (e.g., Order Received, Order Placed, Order Confirmation). When enabled, the Promotion Code and Description will be added to the Order Summary.

      NOTE - The free product and quantity must be added to the sales order manually in Pronto once it has been integrated for the free product to appear as a product line item in the sales receipt. 
  • Postcode Exclusion List - (for free freight promo codes only) If required, enter single postcodes and/or postcode ranges (each comma-separated) to exclude. It is recommended you follow Australia Post's four digit conventions so a three digit code would be '0200' instead of '200'.  

Usage Limits

You can set the maximum 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 one or more users (comma-separated list) who are permitted to use the promotion code. Any user not in this list cannot apply the promo code 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 successfully but the cart contents have been changed so the code is no longer valid.
  • Promotion Code Error Message - The notification displayed when the cart contents are not eligible for the promo code. Perhaps the cart value is not high enough or the minimum quantity has not been reached.
  • Promotion Code Applied Message - The notification displayed when the cart contents are valid for the promo code.

We recommend that Promotion Codes be configured on your Stage site and thoroughly tested to ensure behaviour is as expected.

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



The Promotion Codes feature must be enabled for your website.

Self Configurable


Business Function


BPD Only?




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

Contact Commerce Vision

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

Contact Commerce Vision

Third Party Costs


CMS Category

Campaigns & Promotions → Promotion Codes

Related help