{"title":"Reward Object Reference","slug":"reward-object-reference","url":"https://support.storeconnect.com/articles/reward-object-reference","url_markdown":"https://support.storeconnect.com/articles/reward-object-reference.md","subtitle":null,"summary":"Reward defines the discount to apply when an advanced promotion condition is met. Supports percentage or fixed discounts on the subtotal, products, or shipping, as well as free products and fixed-price product groups.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Reward, s_c__Reward__c, api, advanced promotions, discount","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nReward defines what discount to apply when a [Promotion 2](promotion2-object-reference) condition is met. Reward records are reusable — the same Reward can be linked to multiple promotions via [Promotion 2 Condition](promotion2-condition-object-reference) records.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Reward__c` |\n| **Label** | Reward |\n| **Plural Label** | Rewards |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Apply First To | `s_c__Apply_First_To__c` | Picklist | No | Which items to discount first when applying to multiple products. `most_expensive` (default) or `least_expensive`. Used by `discount_on_products` and `fixed_price_for_n_products` types. |\n| Apply To | `s_c__Apply_To__c` | Picklist | No | Which items this reward targets. `matched_products` (default) — items matched by the condition's product scopes. `specified_products` — items matched by this reward's own product scopes. |\n| Discount Amount | `s_c__Discount_Amount__c` | Currency(18,2) | No | Fixed amount to discount. Used when **Discount Type** is `fixed` for `discount_on_subtotal`, `discount_on_products`, and `discounted_shipping` types. |\n| Discount Percentage | `s_c__Discount_Percentage__c` | Percent(18,2) | No | Percentage to discount (e.g. `10` for 10% off). Used when **Discount Type** is `percentage`. |\n| Discount Points | `s_c__Discount_Points__c` | Number(18,0) | No | Points equivalent of a fixed discount. Used when **Discount Type** is `fixed` and the store operates with a points currency. |\n| Discount Type | `s_c__Discount_Type__c` | Picklist | No | How the discount amount is calculated. `percentage` (default) or `fixed`. |\n| Display Name | `s_c__Display_Name__c` | Text(255) | No | Customer-facing label for this reward. Falls back to Identifier if not set. |\n| Exclude Discounted | `s_c__Exclude_Discounted__c` | Checkbox | No | When checked, items that already have a unit discount are excluded from this reward. Default: unchecked. |\n| Exclude Free | `s_c__Exclude_Free__c` | Checkbox | No | When checked, items with a unit price of zero are excluded from this reward. Default: unchecked. |\n| Fixed Amount | `s_c__Fixed_Amount__c` | Currency(18,2) | No | The fixed price to set per product. Used by the `fixed_price_for_n_products` type. |\n| Fixed Points | `s_c__Fixed_Points__c` | Number(18,0) | No | Points equivalent of the fixed price. Used by the `fixed_price_for_n_products` type in stores operating with a points currency. |\n| Frequency | `s_c__Frequency__c` | Picklist | No | How many times this reward can apply per promotion evaluation. `once` (default) — applies once per evaluation. `no_limit` — applies without limit, repeating for each qualifying group of items. |\n| Identifier | `s_c__Identifier__c` | Text(255) | No | Unique identifier for this reward. Required. Used internally to reference the reward and as a fallback display name. |\n| Max Eligible | `s_c__Max_Eligible__c` | Number(18,0) | No | Maximum number of cart items this reward applies to. Leave blank for no limit. Items are selected in **Apply First To** order before the limit is applied. |\n| Quantity | `s_c__Quantity__c` | Number(18,0) | No | Number of products for `free_product` and `fixed_price_for_n_products` types. For `free_product`, the number of free items to add. For `fixed_price_for_n_products`, the N in \"N products at fixed price\". |\n| Type | `s_c__Type__c` | Picklist | No | The kind of reward. Default: `free_product`. See reward types below. |\n| Description | `—` | — | — | Use the Name field for an internal label; no separate description field exists on Reward. |\n\n## Referenced by\n\nThese objects hold a lookup or master-detail relationship to **Reward** (`s_c__Reward__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__Order_Item_Reward__c](order-item-reward-object-reference) | `s_c__Reward_Id__c` | Lookup | Order_Item_Rewards_Reward | [OrderItem](orderitem-object-reference) |\n| [s_c__Promotion2_Condition__c](promotion2-condition-object-reference) | `s_c__Reward_Id__c` | Lookup | Promotion2_Conditions_Reward | [s_c__Condition__c](condition-object-reference), [s_c__Promotion2__c](promotion2-object-reference) |\n| [s_c__Promotion2_Product_Scope__c](promotion2-product-scope-object-reference) | `s_c__Reward_Id__c` | Lookup | Promotion2_Product_Scopes_Reward | — |\n| [s_c__Reward_Usage__c](reward-usage-object-reference) | `s_c__Reward_Id__c` | Lookup | Reward_Usages_Reward | [Order](order-object-reference), [s_c__Promotion2__c](promotion2-object-reference) |\n\n## Reward types\n\n| Value | Description |\n|-------|-------------|\n| `discount_on_subtotal` | Applies a percentage or fixed discount to the cart subtotal |\n| `discount_on_products` | Applies a percentage or fixed discount to matched or specified products |\n| `discounted_shipping` | Applies a percentage or fixed discount to shipping charges. Set Discount Percentage to `100` for free shipping. |\n| `free_product` | Adds free products to the cart. Set **Quantity** for the number of free items. Define eligible free products using [Promotion 2 Product Scope](promotion2-product-scope-object-reference) records with scope type `free_product`. |\n| `fixed_price_for_n_products` | Sets a fixed price for a quantity of matching products. Set **Quantity** for N and **Fixed Amount** for the price. |\n\n## Field usage by reward type\n\n| Field | discount_on_subtotal | discount_on_products | discounted_shipping | free_product | fixed_price_for_n_products |\n|-------|:---:|:---:|:---:|:---:|:---:|\n| Discount Type | ✓ | ✓ | ✓ | — | — |\n| Discount Percentage | ✓ | ✓ | ✓ | — | — |\n| Discount Amount | ✓ | ✓ | ✓ | — | — |\n| Quantity | — | — | — | ✓ | ✓ |\n| Fixed Amount | — | — | — | — | ✓ |\n| Apply To | — | ✓ | — | — | ✓ |\n| Apply First To | — | ✓ | — | — | ✓ |\n| Max Eligible | — | ✓ | — | — | ✓ |\n| Exclude Discounted | — | ✓ | — | — | — |\n| Exclude Free | — | ✓ | — | — | — |"}