# Rewards

> Rewards are incentives that customers can browse, unlock, and use. Examples of rewards include discounts, free items, and giveaways. Unlocking a reward may require spending loyalty points.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

The **Rewards** page of your account allows you to view, [create](/docs/product/rewards/create-rewards.md#create-a-reward), and [edit](/docs/product/rewards/manage-rewards.md#edit-reward-settings) your rewards. You can define
[user access](/docs/product/account/account-settings/manage-roles.md) to this
page through the account settings.

Each reward is connected to one Application and must be unlocked by the customer before it can be used. If the reward requires points to be unlocked, Talon.One deducts them from the connected loyalty program and subledger.

## List rewards

To list your rewards, on the leftmost menu, click **Incentives** > **Rewards**.

The page that opens displays the rewards in your account. It contains the
following information for each of them:

| Column | Description |
| --- | --- |
| Name | Name of the reward. |
| Application | The [Application](/docs/product/applications/overview.md) connected to the reward. |
| Points required | Number of points a customer must spend to unlock the reward. |
| Program | Loyalty program and subledger from which the points required are deducted. |
| Created | Date and time the reward was created. |
| Last updated | Date and time the reward was last updated. |
| Active | Whether the reward is active. Customers can only unlock active rewards. |
| Actions | Delete the reward <Delete className="icon" />. |

## Reward page

In **Incentives** > **Rewards**, click a reward's name to view its detail page.

The **Rules** tab displays the following information:

- <Tag className="icon" /> **Points required**: Click to set the number of points a customer must spend to unlock the reward. The points are deducted from the specified loyalty program and subledger.
- **Eligibility rule**: Manages who can unlock a reward.
- **Reward rule**: Manages what happens when a customer uses a reward.

The **Settings** tab displays the following information:

- **Name**: Identifies the reward for users in the Campaign Manager.
- **Description**: Optional text that helps users identify the reward in the Campaign Manager.
- **Display name**: Optional, customer-facing name for the reward returned through the Catalog API.
- **Display description**: Optional, customer-facing description for the reward returned through the Catalog API.
- **Related data**: Optional, customer-facing field for the reward returned through the Catalog API.
- **Status**: **Active** or **Inactive**. Only active rewards are available to
  customers.
- **Connected Application**: The [Application](/docs/product/applications/overview.md) where the reward is available.

## Reward statuses

A reward can have the following statuses:

| Status | Description |
| --- | --- |
| **Active** | Customers can see and unlock the reward. |
| **Inactive** | The reward does not appear in the rewards catalog and cannot be unlocked by customers. |

## Customer reward statuses

A reward can have the following statuses for a given customer:

| Status | Description |
| --- | --- |
| **Unlocked** | The customer unlocked the reward. |
| **Used** | The customer applied the reward in a session. |

## Eligibility rule

The eligibility rule lets you manage who can see and unlock a reward, for
example, customers who belong to a specific audience. A customer who doesn't
meet the eligibility rule can still see the reward, but can't unlock it. To
configure this rule, see
[Add an eligibility rule](/docs/product/rewards/create-rewards.md#add-an-eligibility-rule).

## Unlock a reward

When a customer unlocks a reward:

- Talon.One deducts the points required to unlock the reward from the customer's
  [loyalty balance](/docs/product/loyalty-programs/overview.md) in the selected loyalty program and subledger. This deduction is recorded as a loyalty transaction.
- The reward's status for that customer changes to **Unlocked**.

Talon.One records this deduction as a **Redeem loyalty points** effect. To view
it, on the Application's
[Events](/docs/product/applications/display-events.md#list-events) page, click
the number in the **Effects** column for the relevant event.

:::note
A customer can unlock a free reward, with no points required, only one time.
This limit prevents a customer from unlocking the same free reward repeatedly.
:::

## Reward rule

A reward rule lets you manage what happens when a customer uses the reward.
A rule has its own conditions and effects. To configure a reward rule, see
[Add a reward rule](/docs/product/rewards/create-rewards.md#add-a-reward-rule).

A reward rule supports the following effects:

- A discount at the session level, on an individual item, or on an additional
  cost.
- A free item added to the customer's cart.
- An awarded [giveaway](/docs/product/giveaways/overview.md) code.
- A [webhook](/docs/product/rules/effects/available-effects.md#webhooks) triggered when a customer uses the reward.
- A [custom effect](/docs/product/rules/effects/available-effects.md#custom-effects) defined by your integration.

When a customer uses an unlocked reward in a session, Talon.One applies the
effects configured in the reward rule. The reward's status then changes to
**Used**.

If the reward rule produces no effects, the reward status does not change to **Used**.

## Related pages

- [Loyalty programs](/docs/product/loyalty-programs/overview.md)
- [Available effects](/docs/product/rules/effects/available-effects.md)