{"title":"Promotion 2 Usage Object Reference","slug":"promotion2-usage-object-reference","url":"https://support.storeconnect.com/articles/promotion2-usage-object-reference","url_markdown":"https://support.storeconnect.com/articles/promotion2-usage-object-reference.md","subtitle":null,"summary":"Promotion 2 Usage records the application of a promotion to a specific order and customer. Used for usage limit enforcement and reporting.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Promotion 2 Usage, s_c__Promotion2Usage__c, api, advanced promotions, usage tracking","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"Promotion 2 Usage records are created each time a promotion is applied to an order. They track which promotion was used, by which customer, on which order, and the total discount value. These records are used to enforce [total and per-customer usage limits](promotion2-object-reference).\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Promotion2Usage__c` |\n| **Label** | Promotion 2 Usage |\n| **Plural Label** | Promotion 2 Usages |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Account | `s_c__Account_Id__c` | Lookup ([Account](account-object-reference)) | No | The account associated with the order on which this promotion was used. |\n| Contact | `s_c__Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | The contact associated with the order on which this promotion was used. |\n| Order | `s_c__Order_Id__c` | Lookup ([Order](order-object-reference)) | No | The order on which this promotion was applied. |\n| Promotion v2 | `s_c__Promotion2_Id__c` | Lookup ([s_c__Promotion2__c](promotion2-object-reference)) | No | The Promotion 2 that was applied. |\n| Total Value | `s_c__Total_Value__c` | Currency(18,2) | No | Total discount value applied by this promotion to the order. |\n| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | StoreConnect External ID, do not modify in Salesforce |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Account_Id__c` | Lookup | [Account](account-object-reference) | Promotion2_Usages_Account |\n| `s_c__Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Promotion2_Usages_Contact |\n| `s_c__Order_Id__c` | Lookup | [Order](order-object-reference) | Promotion2_Usages_Order |\n| `s_c__Promotion2_Id__c` | Lookup | [s_c__Promotion2__c](promotion2-object-reference) | Promotion2_Usages_Promotion2 |\n\n## Overview\n\nTracks each instance of a Promotion v2 being used on an order, including the customer and total value. Used for enforcing usage limits.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Promotion2_Usage__c` |\n| **Label** | Promotion v2 Usage |\n| **Plural Label** | Promotion v2 Usages |\n| **Type** | Custom Object |"}