{"title":"Promotion 2 Object Reference","slug":"promotion2-object-reference","url":"https://support.storeconnect.com/articles/promotion2-object-reference","url_markdown":"https://support.storeconnect.com/articles/promotion2-object-reference.md","subtitle":null,"summary":"Promotion 2 is the header record for an advanced promotion. Defines scheduling, stacking rules, channel and customer scoping, coupon codes, usage limits, and links to conditions and rewards via Promotion 2 Condition records.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Promotion 2, s_c__Promotion2__c, api, advanced promotions","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\n`Promotion 2` is the header record for the advanced promotion feature. It defines scheduling windows, stacking behavior, channel and customer scoping, coupon codes, and usage limits. Conditions and rewards are attached via [Promotion 2 Condition](promotion2-condition-object-reference) junction records.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Promotion2__c` |\n| **Label** | Promotion v2 |\n| **Plural Label** | Promotions v2 |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Channel Scope Outlet | `s_c__Channel_Scope_Outlet_Id__c` | Lookup ([s_c__Outlet__c](outlet-object-reference)) | No | Restricts this promotion to a specific outlet. Mutually exclusive with Channel Scope Store. |\n| Channel Scope Store | `s_c__Channel_Scope_Store_Id__c` | Lookup ([s_c__Store__c](store-object-reference)) | No | Restricts this promotion to a specific store. Mutually exclusive with Channel Scope Outlet. |\n| Coupon Code | `s_c__Coupon_Code__c` | Text(255) | No | Promotion code entered by the customer at checkout. Leave blank for automatic promotions. Matching is case-insensitive. |\n| Customer Scope Account | `s_c__Customer_Scope_Account_Id__c` | Lookup ([Account](account-object-reference)) | No | Restricts this promotion to a specific account. Mutually exclusive with other customer scope fields. |\n| Customer Scope Contact | `s_c__Customer_Scope_Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | Restricts this promotion to a specific contact. Mutually exclusive with other customer scope fields. |\n| Customer Scope Membership | `s_c__Customer_Scope_Membership_Id__c` | Lookup ([s_c__Membership__c](membership-object-reference)) | No | Restricts this promotion to contacts with a specific active membership. Mutually exclusive with other customer scope fields. |\n| Days of Week | `s_c__Days_Of_Week__c` | Text(255) | No | Days the promotion is active: 0 = Sunday, 1 = Monday, … 6 = Saturday. Leave blank for all days. |\n| Description | `s_c__Description__c` | TextArea | No | Internal description of this promotion. |\n| Display Name | `s_c__Display_Name__c` | Text(255) | No | Customer-facing name for this promotion. |\n| End Date | `s_c__End_Date__c` | Date | No | Last date the promotion is active. Leave blank for no end date. |\n| End Time | `s_c__End_Time__c` | Time | No | Time on the End Date after which the promotion deactivates. Only applies on the end date boundary. |\n| From Time | `s_c__From_Time__c` | Time | No | Daily window start — promotion is only active after this time each day. |\n| Per Customer Usage Limit | `s_c__Per_Customer_Usage_Limit__c` | Number(18,0) | No | Maximum number of times a single customer can use this promotion. Leave blank for unlimited. |\n| Priority | `s_c__Priority__c` | Number(18,0) | No | Evaluation order across all Promotion 2 records. Lower numbers are evaluated first. |\n| Reward Strategy | `s_c__Reward_Strategy__c` | Picklist | No | Controls how multiple Promotion 2 Conditions are applied. `tiered` (default) — only the highest-priority matching condition applies. `stacked` — all matching conditions apply. |\n| Stacking Behaviour | `s_c__Stacking_Behaviour__c` | Picklist | No | Controls whether this promotion combines with others. `stackable` (default) — can combine. `not_stackable` — conflicts with other non-stackable promotions. |\n| Stacking Priority | `s_c__Stacking_Priority__c` | Picklist | No | Tie-breaker when two non-stackable promotions conflict. `existing_promotions` (default) — keep already-applied promotions. `biggest_reward` — keep whichever gives the largest discount. |\n| Start Date | `s_c__Start_Date__c` | Date | No | First date the promotion is active. |\n| Start Time | `s_c__Start_Time__c` | Time | No | Time on the Start Date from which the promotion activates. Only applies on the start date boundary. |\n| Stop After This Promo | `s_c__Stop_After_This_Promo__c` | Checkbox | No | When checked, no further promotions are evaluated after this one applies. Default: unchecked. |\n| Store | `s_c__Store_Id__c` | Lookup ([s_c__Store__c](store-object-reference)) | No | The store this promotion belongs to. |\n| Timezone | `s_c__Timezone__c` | Text(100) | No | Timezone for all time-based fields. Defaults to the store's timezone. |\n| To Time | `s_c__To_Time__c` | Time | No | Daily window end — promotion is only active before this time each day. |\n| Total Usage Limit | `s_c__Total_Usage_Limit__c` | Number(18,0) | No | Maximum total uses across all customers. Leave blank for unlimited. |\n| Week Frequency | `s_c__Week_Frequency__c` | Number(18,0) | No | Recurrence frequency in weeks from Start Date. 1 = every week (default), 2 = every two weeks. |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Channel_Scope_Outlet_Id__c` | Lookup | [s_c__Outlet__c](outlet-object-reference) | Promotions_v2_Channel_Scope_Outlet |\n| `s_c__Channel_Scope_Store_Id__c` | Lookup | [s_c__Store__c](store-object-reference) | Promotions_v2_Channel_Scope_Store |\n| `s_c__Customer_Scope_Account_Id__c` | Lookup | [Account](account-object-reference) | Promotions_v2_Customer_Scope_Account |\n| `s_c__Customer_Scope_Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Promotions_v2_Customer_Scope_Contact |\n| `s_c__Customer_Scope_Membership_Id__c` | Lookup | [s_c__Membership__c](membership-object-reference) | Promotions_v2_Customer_Scope_Membership |\n| `s_c__Store_Id__c` | Lookup | [s_c__Store__c](store-object-reference) | Promotions_v2_Store |\n\n## Referenced by\n\nThese objects hold a lookup or master-detail relationship to **Promotion v2** (`s_c__Promotion2__c`). Where the referring record exists to join things together, **Also links to** shows what it connects this object to.\n\n| Object | Field | Type | Relationship Name | Also links to |\n|--------|-------|------|-------------------|---------------|\n| [s_c__Cart_Item__c](cart-item-object-reference) | `s_c__Promotion2_Id__c` | Lookup | Cart_Item_Promotion2 | — |\n| [s_c__Cart_Promotion2__c](cart-promotion2-object-reference) | `s_c__Promotion2_Id__c` | Lookup | Cart_Promotions_v2_Promotion2 | [s_c__Cart__c](cart-object-reference) |\n| [s_c__Promotion2_Condition__c](promotion2-condition-object-reference) | `s_c__Promotion2_Id__c` | Lookup | Promotion2_Conditions_Promotion2 | [s_c__Condition__c](condition-object-reference), [s_c__Reward__c](reward-object-reference) |\n| [s_c__Promotion2_Usage__c](promotion2-usage-object-reference) | `s_c__Promotion2_Id__c` | Lookup | Promotion2_Usages_Promotion2 | — |\n| [s_c__Reward_Usage__c](reward-usage-object-reference) | `s_c__Promotion2_Id__c` | Lookup | Reward_Usages_Promotion2 | [Order](order-object-reference), [s_c__Reward__c](reward-object-reference) |"}