Condition Object Reference
On this page
Overview
Condition defines what must be true for a Promotion 2 reward to apply. Condition records are reusable — the same Condition can be linked to multiple promotions via Promotion 2 Condition records.
| Property | Value |
|---|---|
| API Name | s_c__Condition__c |
| Label | Condition |
| Plural Label | Conditions |
| Type | Custom Object |
Fields
| Field Label | API Name | Type | Required | Description |
|---|---|---|---|---|
| Amount | s_c__Amount__c |
Currency(18,2) | No | Threshold value for the condition. Required for total_value, total_quantity, and product_count types. Not used by always_applies or liquid_condition types. |
| Currency | s_c__Currency__c |
Text(10) | No | ISO currency code (e.g. AUD, USD). When set, the condition only evaluates as true if the cart currency matches. Leave blank to apply to all currencies. |
| Description | s_c__Description__c |
LongTextArea | No | Internal description of this condition. |
| Liquid Condition POS | s_c__Liquid_Condition_Pos__c |
LongTextArea | No | Liquid template evaluated when this condition is used in a POS context. Used by the liquid_condition type only. |
| Liquid Condition Web | s_c__Liquid_Condition_Web__c |
LongTextArea | No | Liquid template evaluated when this condition is used in a web (storefront) context. Used by the liquid_condition type only. |
| Type | s_c__Type__c |
Picklist | No | The kind of check this condition performs. Default: always_applies. See condition types below. |
Condition types
| Value | Description | Amount required |
|---|---|---|
always_applies |
No qualification required — the condition always evaluates as true | No |
total_value |
Cart subtotal of eligible items must be at or above the Amount | Yes |
total_quantity |
Total item quantity of eligible items must be at or above the Amount | Yes |
product_count |
Number of distinct products in eligible items must be at or above the Amount | Yes |
liquid_condition |
Custom logic evaluated via a Liquid template at runtime | No |
Product filtering
Set Promotion 2 Product Scope records on a Condition to filter which cart items are considered before the condition is evaluated. When product scopes are present, only matching items count toward the threshold amount or quantity.
:::note
For liquid_condition type, define Liquid Condition Web for storefront evaluations and Liquid Condition POS for POS evaluations. If the template for the current context is blank, the condition evaluates as true (passes).
:::