Skip to end of metadata
Go to start of metadata


Cart Discount promotion codes give your customers either a percentage or dollar discount on their order. To be eligible, the customer simply needs to meet a minimum spend requirement.

If you like, you can even exclude certain products from the promotion. Excluded products will not count toward the spend requirement, and may or may not be discounted.

In the example below, we'll create a Cart Discount promotion for '20% off orders over $250'. This promo will exclude exercise machines. 

The Promotion Codes feature must be enabled for your website. On BPD sites, you can do this at SettingsPayment & CheckoutPromotion Codes

Step-by-step guide

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

  2. On the top right of the screen, click 'Add Promotion Code'.

  3. From Select Promotion Type, select Cart.

  4. Next, decide whether your customer will get a dollar or percentage discount and select your scenario accordingly. Our example will use the % discount.

  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. NOTE - If start and end dates are not set, the promotion code cannot be used. An error message will display when the customer tries to apply the code during checkout.

  8. Enter the Spend Threshold (the $ amount they must spend), and the associated Discount % or $ amount.  
    (Our example only requires one level of discounting, but if you're interested in multi-level discounts, see our article on Tiered Promotions.)

    Note that the spend requirement is based on the inc-GST total for B2C, and the ex-GST total for B2B. Also note that for B2B scenarios, any customer-based discounts will still be honoured; this discount will be on top of that.

  9. Next you can specify products to be excluded. Click Add and specify products you want to exclude from the spend calculation. Specify by:
    • Product code 
    • ERP stock group 
    • Product category
    • ERP price code
    • Or a combination of all of the above!

  10. Finally, decide whether you want to 'Discount these exclusions'?
    Excluded products don't count toward the required spend, but you can still allow them to attract the discount if you choose. Otherwise, leave the option unticked to exclude them from the discount as well as the spend threshold. 

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

  12. Click Save & Exit.

Your cart discount promo is now ready to go!

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': 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 your website altogether and cannot be retrieved 
  • 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

Cart Discount Promos can now be configured to exclude products, product groups, or product categories from the promotion.

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.

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