Skip to end of metadata
Go to start of metadata


Who doesn't love free stuff?! Give your customers a token of your appreciation with a Free Product promotion.

You can configure a free product promo in several ways:

  1. Your customer spends $X overall, and gets the freebie.
  2. Your customer spends $X on specific products, and gets the freebie.
  3. Your customer buys X quantity of specific products, and gets the freebie.

Configuring these promotions in the CMS is quick and easy. We'll go through an example below, using scenario 3. 

Step-by-step guide

To add a product promo code:

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

  2. Click Add Promotion Code.

  3. Select Product from the Promotion Type list.

  4. Choose the scenario you want to use. You can base it on overall spend, dollar spend on eligible products, or quantity buy on eligible products. 

    We'll base ours on a quantity requirement. 

  5. Enter your 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 Discount Threshold. This is the dollar amount the customer must spend (or in our case, the quantity they must purchase) to qualify for the free product.

  9. If your promotion is based on a set of Eligible Products, specify them here (otherwise, skip to step 12).  If your list of eligible products is long, you may wish to import them from a .csv file

    Click Add and specify products by product code, ERP stock group, or category. You can even use a combination of all three if you like!

    In our example, we'll specify 3 different products as shown:

  10. Specify the Free Product. Enter a description or code and suggestions will populate as you type.

  11. Nominate the quantity of free product the customer will receive. 

  12. Apply In Multiples? Tick this to allow multiple redemptions in the one order. For example, "1 free widget with every 10 shirts purchased" would entitle a user buying 30 shirts to 3 free widgets. 

  13. Save & Exit.

Your free product promotion is ready to go! 

The free product will be added to your customer's order on integration to your ERP.

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.

 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

Related widgets