# Reward Object Reference

Source: https://support.storeconnect.com/articles/reward-object-reference · Last modified 21 August 2026

## Overview

Reward 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.

| Property | Value |
|----------|-------|
| **API Name** | `s_c__Reward__c` |
| **Label** | Reward |
| **Plural Label** | Rewards |
| **Type** | Custom Object |

## Fields

| Field Label | API Name | Type | Required | Description |
|-------------|----------|------|----------|-------------|
| 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. |
| 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. |
| 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. |
| 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`. |
| 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. |
| Discount Type | `s_c__Discount_Type__c` | Picklist | No | How the discount amount is calculated. `percentage` (default) or `fixed`. |
| Display Name | `s_c__Display_Name__c` | Text(255) | No | Customer-facing label for this reward. Falls back to Identifier if not set. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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". |
| Type | `s_c__Type__c` | Picklist | No | The kind of reward. Default: `free_product`. See reward types below. |
| Description | `—` | — | — | Use the Name field for an internal label; no separate description field exists on Reward. |

## Referenced by

These 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.

| Object | Field | Type | Relationship Name | Also links to |
|--------|-------|------|-------------------|---------------|
| [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) |
| [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) |
| [s_c__Promotion2_Product_Scope__c](promotion2-product-scope-object-reference) | `s_c__Reward_Id__c` | Lookup | Promotion2_Product_Scopes_Reward | — |
| [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) |

## Reward types

| Value | Description |
|-------|-------------|
| `discount_on_subtotal` | Applies a percentage or fixed discount to the cart subtotal |
| `discount_on_products` | Applies a percentage or fixed discount to matched or specified products |
| `discounted_shipping` | Applies a percentage or fixed discount to shipping charges. Set Discount Percentage to `100` for free shipping. |
| `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`. |
| `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. |

## Field usage by reward type

| Field | discount_on_subtotal | discount_on_products | discounted_shipping | free_product | fixed_price_for_n_products |
|-------|:---:|:---:|:---:|:---:|:---:|
| Discount Type | ✓ | ✓ | ✓ | — | — |
| Discount Percentage | ✓ | ✓ | ✓ | — | — |
| Discount Amount | ✓ | ✓ | ✓ | — | — |
| Quantity | — | — | — | ✓ | ✓ |
| Fixed Amount | — | — | — | — | ✓ |
| Apply To | — | ✓ | — | — | ✓ |
| Apply First To | — | ✓ | — | — | ✓ |
| Max Eligible | — | ✓ | — | — | ✓ |
| Exclude Discounted | — | ✓ | — | — | — |
| Exclude Free | — | ✓ | — | — | — |

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/reward-object-reference