Skip to content
Log in

Promotion Action Object Reference

On this page

Overview

Provides the discount that is applied when this promotion is added to a cart. Reductions can be via a fixed amount or a percentage. Available actions can be discount per item, for the whole order, free/discounted shipping, and buy one get one free/discounted.

Property Value
API Name s_c__Promotion_Action__c
Label Promotion Action
Plural Label Promotion Actions
Type Custom Object

Fields

Field Label API Name Type Required Description
Action s_c__Action__c Picklist Yes Defines how this promotion is applied to the shopping cart. Available options are per order, per item in the order, discounted or free shipping, or a buy one get another at a discount. Used in conjunction with Promotion_Scope__c which determines qualifying items.
Calculation Type s_c__Calculation__c Picklist Yes Defines whether the promotion is a fixed value or a percantage.
Discount Percentage s_c__Discount_Percent__c Percent(18,2) No The percentage amount to apply to the promotion as a discount. This is required when Calculation__c is set to “Discount Percentage”.
Discount Points Amount s_c__Discount_Value_Points__c Number(18,0) No The fixed amount of points to apply to the promotion as a discount. This is required when Calculation__c is set to “Discount Amount”.
Discount Amount s_c__Discount_Value__c Currency(18,2) No The fixed amount to apply to the promotion as a discount. This is required when Calculation__c is set to “Discount Amount”.
Dynamic Discount Points Amount s_c__Dynamic_Discount_Value_Points__c LongTextArea(5000) No An expression in Liquid syntax that supplies the promotion discount points amount. This is required when Calculation__c is set to “Dynamic Amount”.
Dynamic Discount Amount s_c__Dynamic_Discount_Value__c LongTextArea(5000) No An expression in Liquid syntax that supplies the promotion discount amount. This is required when Calculation__c is set to “Dynamic Amount”.
Promotion s_c__Promotion_Id__c MasterDetail (s_c__Promotion__c) No The promotion this action applies to.
Qualifying Quantity s_c__Qualifying_Quantity__c Number(18,0) No The number of items a user needs to purchase before the discount is applied.
StoreConnect External ID s_c__sC_Id__c Text(36) No StoreConnect External ID, do not modify in Salesforce

Relationships

Field Type Related Object Relationship Name
s_c__Promotion_Id__c MasterDetail s_c__Promotion__c Promotion_Actions

Referenced by

These objects hold a lookup or master-detail relationship to Promotion Action (s_c__Promotion_Action__c). Where the referring record exists to join things together, Also links to shows what it connects this object to.

Object Field Type Relationship Name Also links to
s_c__Promotion_Credit__c s_c__Promotion_Action_Id__c Lookup Promotion_Credits Order, s_c__Promotion__c

On the storefront

Storefront templates read this object through the PromotionAction Liquid object, written as promotion_action in a theme.

Salesforce field Liquid attribute
s_c__Action__c promotion_action.action
s_c__Calculation__c promotion_action.calculation
s_c__Discount_Percent__c promotion_action.discount_percent
s_c__Discount_Value_Points__c promotion_action.discount_value_points
s_c__Discount_Value__c promotion_action.discount_value
s_c__Qualifying_Quantity__c promotion_action.qualifying_quantity

Fields you add yourself are not listed above. Expose one with a Custom Data Mapping record, then read it from promotion_action.data. See custom data fields in Liquid.

Was this article helpful?

Was this article helpful?