You must define promotion limits to determine the number of times you customer can apply a promotion for different types of the transactions.


To define the limit of a promotion,

  1. On the left work pane, click Limits.
  2. Click Add to add a new limit and Delete to delete a limit.
  3. Enter values for the fields described in the following table:

    Field Name

    Description

    To Whom Does the Limit Apply?

    Enables you specify the object on which the limit is applied. The objects on which limit is applicable on are Account, User, and Contact.

    You can select specific values for all the objects:

    • Account: All, Bill To, and Ship To
    • Contact: All
    • User: All, Created By ID, and Last Modified By ID


    Limit Metric

    Specifies what will be the parameter on which the limit is applicable.

    Benefit Quantity: Specifies that the discount would be applied on a fixed quantity.

    Max Limit Value TypeSpecifies that a limit will be a constant value.
    Limit Value

    Specifies the value of the Limit Metric. For example, if you specify the limit value as 10 and the limit metric as Benefit Quantity, the user can use the same promo code when the Quantity of the product is 10.

    If you enable Setup > Build > Develop > Custom Settings > Incentive System Properties > Manage > Enforce Limits, when a quote is finalized, CPQ applies the incentive limit across quotes in the same account. For example, if Limit Value is 5 and there are two quotes with three cart line items each, CPQ applies the incentive limit on three items in the first quote and two items in the second quote.

    If you disable Setup > Build > Develop > Custom Settings > Incentive System Properties > Manage > Enforce Limits, only when a quote is accepted, CPQ applies the incentive limit on each quote of an account. For example, if Limit Value is 5 and there are two quotes with five cart line items each, CPQ applies the incentive limit on five items in the first quote and five items in the second quote. CPQ resets the incentive limit for each quote.

    The incentive limit is applicable when users finalize the cart. If they abandon the cart where promotion is applied, CPQ resets the incentive limit.

    Recurrence TypeSpecifies whether the limit applied is one time or on a recurring basis.
    Recurrence FrequencySpecifies the frequency at which the applied incentives are limited. Available frequencies are MonthlyQuarterlyHalf YearlyYearlyOrder.
  4. Click Save to save the changes or click Save & Continue to move to the next tab.

Expected Behavior

Options Selected

Expected behavior

Auto Apply deselected, Combine with Other incentives selected

You can build a User Interface to display the “Show Available Promotions” list using the Promotions API, which displays non-auto applied promotions.

The user can then select one or multiple promotions to be applied.

Auto Apply deselected, combine with other incentives deselected

If a user provides multiple promo codes as a comma-separated list, the highest priority promotion is selected and applied from the list of promotions provided in the comma-separated list.


Auto-Apply selected, combine with other incentives deselected

If two or more promotions are applicable, the system picks the promotion with the highest priority and applies it.

Auto-apply selected, combine with other incentives selected

All promo codes fulfilling the criteria will be applied. If one or more promo codes have priority 1 which is applicable in a scenario all the promotions are applied. Suppose for a given scenario there are 4 promo codes which are applicable having priority 1,1,2,2 all four are applied.

Pricing is not stacked, so if all the four qualify and allow others to be applied then all four are applied.

If some of the promotions do not allow others to be applied then those promotions are filtered out.

After defining promotions, ensure that you run Criteria Maintenance > Update Pricing Fields to apply the defined promotions.