{"title":"Promotion 2 Product Scope Object Reference","slug":"promotion2-product-scope-object-reference","url":"https://support.storeconnect.com/articles/promotion2-product-scope-object-reference","url_markdown":"https://support.storeconnect.com/articles/promotion2-product-scope-object-reference.md","subtitle":null,"summary":"Promotion 2 Product Scope defines which products, categories, or brands a condition or reward applies to. Use include or exclude scope types to filter the cart items considered by a condition, or to specify free products for a free_product reward.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Promotion 2 Product Scope, s_c__Promotion2ProductScope__c, api, advanced promotions, product filtering","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nPromotion 2 Product Scope records define which products a Condition or Reward targets. They are attached to either a Condition or a Reward and control which cart items are considered during promotion evaluation.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Promotion2_Product_Scope__c` |\n| **Label** | Promotion v2 Product Scope |\n| **Plural Label** | Promotion v2 Product Scopes |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Brand | `s_c__Brand_Id__c` | Lookup ([Account](account-object-reference)) | No | Target a brand (Account). Only one of Brand, Category, Product, or Zone should be set per record. |\n| Category | `s_c__Category_Id__c` | Lookup ([s_c__Product_Category__c](product-category-object-reference)) | No | Target a product category (Taxon) and all its subcategories. Only one of Brand, Category, Product, or Zone should be set per record. |\n| Condition | `s_c__Condition_Id__c` | Lookup ([s_c__Condition__c](condition-object-reference)) | No | The Condition this scope filters. Set this or Reward, not both. |\n| Product | `s_c__Product_Id__c` | Lookup ([Product2](product2-object-reference)) | No | Target a specific product (including its variants). Only one of Brand, Category, Product, or Zone should be set per record. |\n| Reward | `s_c__Reward_Id__c` | Lookup ([s_c__Reward__c](reward-object-reference)) | No | The Reward this scope applies to. Set this or Condition, not both. |\n| Scope Type | `s_c__Scope_Type__c` | Picklist | No | How this scope is applied (see below). |\n| Zone | `s_c__Zone_Id__c` | Lookup ([s_c__Zone__c](zone-object-reference)) | No | Target a shipping zone. Used with shipping-related conditions or rewards. |\n\n## Scope types\n\n| Value | Description |\n|-------|-------------|\n| `include` | Only cart items matching this scope are considered by the condition or reward |\n| `exclude` | Cart items matching this scope are excluded from consideration |\n| `free_product` | Used with `free_product` reward type — defines which products can be given as the free item |\n\nWhen both include and exclude scopes are present on the same Condition or Reward, an item must match an include scope AND not match any exclude scope to be eligible.\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Brand_Id__c` | Lookup | [Account](account-object-reference) | Promotion2_Product_Scopes_Brand |\n| `s_c__Category_Id__c` | Lookup | [s_c__Product_Category__c](product-category-object-reference) | Promotion2_Product_Scopes_Category |\n| `s_c__Condition_Id__c` | Lookup | [s_c__Condition__c](condition-object-reference) | Promotion2_Product_Scopes_Condition |\n| `s_c__Product_Id__c` | Lookup | [Product2](product2-object-reference) | Promotion2_Product_Scopes_Product |\n| `s_c__Reward_Id__c` | Lookup | [s_c__Reward__c](reward-object-reference) | Promotion2_Product_Scopes_Reward |\n| `s_c__Zone_Id__c` | Lookup | [s_c__Zone__c](zone-object-reference) | Promotion2_Product_Scopes_Zone |"}