Promotion Object Reference
Overview
Promotions are codes that allow your shoppers to get a discount on their shopping cart. Unlike Discounts that are automatically applied, a promotion is only applied if the shopper enters an active promo code during the checkout process. Promotions can be filtered using Promotion Scopes against accounts, contacts, product categories, brands, products, memberships, or pricebooks to limit where they can be used.
| Property |
Value |
| API Name |
s_c__Promotion__c |
| Label |
Promotion |
| Plural Label |
Promotions |
| Type |
Custom Object |
Fields
| Field Label |
API Name |
Type |
Required |
Description |
| Advertise |
s_c__Advertise__c |
Checkbox |
No |
[Future use] Flag that determines whether the promotion is included in the Advertised Promotions collection in liquid. |
| Campaign |
s_c__Campaign_Id__c |
Lookup (Campaign) |
No |
Setting this to a standard Salesforce Campaign record will save the contact that used the promotion into the specified Campaign. |
| Description |
s_c__Description__c |
TextArea |
No |
Internal description of this promotion. |
| The time this promotion expires |
s_c__Expires_At__c |
DateTime |
No |
The exact time after which this promotion will not be valid and not be able to be used. The time zone used is per the users time zone setting in Salesforce and the time is then converted and saved as the equivalent time in UTC. This means if you are setting a future date, be sure to take any time zone changes into account. |
| Path |
s_c__Path__c |
Text(255) |
No |
[Future use] This is the path that is added to the store to show a special promotion page. |
| Promotion Code |
s_c__Promotion_Code__c |
Text(200) |
Yes |
The promotion code that will be entered by the shopper during checkout in order to use this promotion. |
| The time this promotion starts |
s_c__Starts_At__c |
DateTime |
No |
The exact time before which this promotion will not be valid and not be able to be used. The time zone used is per the users time zone setting in Salesforce and the time is then converted and saved as the equivalent time in UTC. This means if you are setting a future date, be sure to take any time zone changes into account. |
| Store |
s_c__Store_Id__c |
Lookup (s_c__Store__c) |
Yes |
The store which this promotion is active on. A promotion can only be associated with one store. |
| Unique Store and Promotion Code |
s_c__Unique_Promotion_Code_Store__c |
Text(255) |
No |
Ensure each store can only have one promotion with the same code |
| Usage Limit |
s_c__Usage_Limit__c |
Number(18,0) |
No |
How many times a promotion can be used during checkout. A null value allows this promotion to be used an unlimited number of times. |
| 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__Campaign_Id__c |
Lookup |
Campaign |
Promotions |
s_c__Store_Id__c |
Lookup |
s_c__Store__c |
Promotions |
Last updated March 6, 2025
