Promotion Scope Object Reference
On this page
Overview
The optional scope to limit this promotion by. Can be by account, contact, product, product category, brand or membership. The Product in promotion scope can also be used for the buy one get one free promotion action type. Multiple scopes are supported
| Property | Value |
|---|---|
| API Name | s_c__Promotion_Scope__c |
| Label | Promotion Scope |
| Plural Label | Promotion Scopes |
| Type | Custom Object |
Fields
| Field Label | API Name | Type | Required | Description |
|---|---|---|---|---|
| Account | s_c__Account_Id__c |
Lookup (Account) | No | What account is eligible to use this promotion. |
| Brand | s_c__Brand_Id__c |
Lookup (Account) | No | The brand that is included in this promotion. Brands are a special type of Account where Account.Supplier__c equals true and can also be associated with products. |
| Category | s_c__Category_Id__c |
Lookup (s_c__Product_Category__c) | No | The product category whose products this promotion can be used with. If the product category selected is a top-level category, all its subcategories are included in this promotion. |
| Conditions | s_c__Conditions__c |
LongTextArea(1024) | No | An expression in Liquid syntax that refines the Promotion’s scope. |
| Contact | s_c__Contact_Id__c |
Lookup (Contact) | No | The contact that can apply this promotion. |
| Membership | s_c__Membership_Id__c |
Lookup (s_c__Membership__c) | No | Members can us the promo code for this Promotion. |
| Price Book | s_c__Pricebook_Id__c |
Lookup (Pricebook2) | No | Any product using the selected pricebook is included in this promotion. |
| Product | s_c__Product_Id__c |
Lookup (Product2) | No | The specific product that this promotion can be used with. If a master product is selected, all its variants are also included in this promotion. |
| Promotion | s_c__Promotion_Id__c |
MasterDetail (s_c__Promotion__c) | No | The Promotion that this scope applies to. |
| 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__Account_Id__c |
Lookup | Account | Account_Promotions |
s_c__Brand_Id__c |
Lookup | Account | promotions_for_brand |
s_c__Category_Id__c |
Lookup | s_c__Product_Category__c | Product_Category_Promotions |
s_c__Contact_Id__c |
Lookup | Contact | Contact_Promotions |
s_c__Membership_Id__c |
Lookup | s_c__Membership__c | Promotion_Scopes |
s_c__Pricebook_Id__c |
Lookup | Pricebook2 | promotions_for_pricebook |
s_c__Product_Id__c |
Lookup | Product2 | Product_Promotions |
s_c__Promotion_Id__c |
MasterDetail | s_c__Promotion__c | Promotion_Scopes |
On the storefront
Storefront templates read this object through the PromotionScope Liquid object, written as promotion_scope in a theme.
Fields you add yourself are not listed above. Expose one with a Custom Data Mapping record, then read it from promotion_scope.data. See custom data fields in Liquid.
Was this article helpful?
Thanks for your feedback! It helps us improve our docs.