> ## Documentation Index
> Fetch the complete documentation index at: https://voucherify-rc-lv2-guides.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create loyalty rewards

> Configure digital and material rewards for loyalty programs, define spendings, and manage rewards in the Loyalty hub

<Info>
  This page describes how to create rewards in the **Loyalty hub**. These rewards can be used only in loyalty programs. To create rewards for legacy loyalty campaigns and referral campaigns, read the [Create rewards](/optimize/create-rewards) page.
</Info>

Rewards are items that loyalty members redeem by spending points. You can offer discount coupons, gift cards, or physical products.

Go to **Loyalty hub** > **Rewards** and click **Create reward**.

## Rewards list

The **Loyalty rewards** section lists all rewards created in your project. Each reward appears as a row with the following columns:

* **Status**: Shows whether the reward is **Active**, **Inactive**, or **Draft**.
* **Name**: The name of the reward.
* **Type**: The reward type: **Digital** or **Material**.
* **Reward**: The name of the resource connected to this reward, such as a campaign or product.
* **Refundable**: Shows whether points spent on this reward can be returned after a refund: **Refundable** or **Non-refundable**.
* **Created**: The date and time the reward was created.

Use the search bar to find a reward by name. Use **Add filter** to narrow the list by **Loyalty reward attributes**.

* **Name**: Filter by reward name.
* **Type**: Filter by reward type.
* **Creation date**: Filter by when the reward was created.

## Create a reward

<Info>
  <Badge color="gray">Prerequisite: Sources of rewards</Badge>

  Before creating a reward, prepare the resources required for the selected reward type.

  Depending on the reward type, you may need:

  * A discount campaign for discount coupon rewards.
  * A gift cards campaign for gift card rewards.
  * A point wallet for points on loyalty card rewards.
  * A product or SKU for material rewards.
</Info>

Start by entering a name in the **Name reward** field. If a required field is missing or settings are incompatible, you will see an **Action required** message. You can also **Save draft** and finish the setup later.

<Steps>
  <Step>
    ### Details

    Choose the reward type and configure the reward.

    <Tabs>
      <Tab title="Digital reward">
        Digital rewards issue a discount coupon or gift card to the member.

        Select the **Digital reward type**.

        <Tabs>
          <Tab title="Discount coupons">
            Issues a discount coupon from an existing discount campaign. In **Discount campaign**, select the campaign to issue coupons from.
          </Tab>

          <Tab title="Gift cards">
            Issues a gift card from an existing gift card campaign.

            * **Gift card campaign**: Select the campaign to issue gift cards from.
            * **Gift card balance**: Set the balance added to the initial amount of the gift card when issued.

            <Tip>
              Set **Gift card balance** to `0` if you don't want to top up the card beyond its initial amount.

              For example, if the members can buy a gift card as a reward from a campaign which generates cards with \$100 credits, it's better to use `0`. If you set here `10`, the member will get a gift card reward with a \$110 credit.

              If you want to create a reward that only tops up the current gift card balance, set the desired value. For example, if you set `10` and the member has a gift card with \$46 balance currently, they can use the reward to buy additional credits with loyalty points and top the card up to \$56.
            </Tip>
          </Tab>

          <Tab title="Points on loyalty card">
            Grants points directly to a loyalty card in a selected point wallet.

            * **Target point wallet**: Select the point wallet where points will be added.
            * **Points to grant**: Set how many points to add.

            <Note>
              This reward type works only with new loyalty programs. You can't set this reward for legacy loyalty campaigns.
            </Note>
          </Tab>
        </Tabs>
      </Tab>

      <Tab title="Material reward">
        Material rewards represent a physical product or SKU that members can redeem.

        Use **Product or SKU** to search for an existing product by typing at least 3 characters.

        If the product doesn't exist yet, use **+** to **Add product**:

        * **Product name**: the name of the product (required).
        * **Source ID**: an optional external identifier for the product.
        * **Price**: the price of the product.
        * **Attributes**: optional product attributes.
      </Tab>
    </Tabs>

    Select **Refundable** to allow points spent on this reward to be returned after a refund.
  </Step>

  <Step>
    ### Spendings

    **Spending** defines how much a reward will cost in points, which point wallet will be used, as well as it determines other conditions. Spendings are evaluated top to bottom. If a member doesn't match the first spending configuration, Voucherify checks the next one in order until a spending is fulfilled. If no spending is fulfilled, the reward can't be redeemed.

    <Info>
      If a member's wallet doesn't have enough points, Voucherify doesn't automatically try another point wallet. Add another spending to cover that case.
    </Info>

    Use **+ Add spending** to create additional spending configurations. Drag spendings to change their priority. You can add up to 10 spendings.

    Each spending configuration consists of the following steps.

    <Steps>
      <Step title="Spending name">
        Enter an internal name to identify the spending configuration.
      </Step>

      <Step title="Tier (optional)">
        Use the **Tier** section to select which loyalty tiers the spending applies to (optional).

        Leave the **Tiers** field blank to apply the spending to all loyalty members.
      </Step>

      <Step title="When (optional)">
        Use the **When** section to define conditions for the spending configuration (optional).

        Use **Add rule** to create conditions and **Add brackets** to group multiple conditions into logical expressions.

        Conditions are grouped by category.

        <Tabs>
          <Tab title="Audience">
            Audience rules define member-based conditions:

            * **Customer segment**: Checks whether the customer belongs to a selected segment.
          </Tab>

          <Tab title="Customer metadata">
            Customer metadata rules define conditions based on customer metadata values.

            Available metadata keys depend on the customer metadata schema configured in your project.

            Use **Add to schema** to create a new metadata key directly from the builder.
          </Tab>

          <Tab title="Member metadata">
            Member metadata rules define conditions based on member metadata values.

            Available metadata keys depend on the member metadata schema configured in your project.

            Use **Add to schema** to create a new metadata key directly from the builder.
          </Tab>
        </Tabs>

        The following actions are available when configuring rules and brackets.

        <AccordionGroup>
          <Accordion title="Rule actions">
            After adding a rule, use the three-dot menu next to the rule name to manage rule actions.

            Available rule actions:

            * **Error message**: Defines a custom validation message for the selected rule.
            * **Edit rule**: Updates the selected rule configuration.
            * **Duplicate rule**: Creates a copy of the selected rule.
            * **Add next rule**: Adds another rule after the selected rule.
            * **Add next brackets**: Adds a new bracket group after the selected rule.
            * **Remove rule**: Removes the selected rule from the spending configuration.
            * **Surround with brackets**: Groups the selected rule inside brackets.
          </Accordion>

          <Accordion title="Bracket actions">
            Use the three-dot menu on the right side of the bracket group to manage bracket actions.

            Available bracket actions:

            * **Add rule**: Adds a new rule inside the selected bracket group.
            * **Add next rule**: Adds a new rule after the selected bracket group.
            * **Add brackets**: Adds a nested bracket group inside the selected bracket group.
            * **Add next brackets**: Adds a new bracket group after the selected bracket group.
            * **Remove brackets and rules inside**: Removes the selected bracket group together with all rules inside it.
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="Then redeem from">
        Use the **Then redeem from** section to define which point wallet is used and how many points the redemption costs.

        Configure the following fields:

        * **Point wallet**: Selects the point wallet from which points are deducted when the reward is redeemed.
        * **Points cost**: The number of points required to redeem this reward.

        <Tip>
          If you want the reward to be redeemed with different point values from various point wallets in one loyalty program, add another spending.
        </Tip>

        <Note>
          A reward can be redeemed from point wallets that belong to one loyalty program. If you configure point wallets that belong to different loyalty programs, you won't be able to assign the reward to a program.

          Also, if you assign the reward to a loyalty program, you won't be able to configure spendings with point wallets from other programs.
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step>
    ### Timeframe

    Define when the reward can be redeemed and when it is no longer available.

    <Note>
      Time-related settings in timeframe configuration use the time zone configured in [Project settings](/manage/project-settings).
    </Note>

    #### Starts on

    Define when the reward becomes active.

    Available options:

    * **Creation**: The reward becomes active immediately after it is created.
    * **Specific date**: The reward becomes active at a selected date and time.

    When **Specific date** is selected, configure:

    * **Date**: Activation date.
    * **Time**: Activation time.

    #### Expires

    Define when the reward stops being active, so it becomes unavailable for redemption.

    Available options:

    * **Never**: The reward doesn't expire and it's always available.
    * **On specific date**: The reward expires at a selected date and time. It is no longer available after this date.

    When **On specific date** is selected, configure:

    * **Date**: Expiration date.
    * **Time**: Expiration time.

    #### Valid hours per day

    By default the reward is available for redemption throughout all days of the week, all day long.

    Use **+ Add valid hours per day** to limit when the reward can be redeemed during the week.

    When configuring valid hours, define:

    * **Start time**: Beginning of the valid time range.
    * **Expiration time**: End of the valid time range.
    * **Days of the week**: Days when the reward is active within the selected time range.

    Available days:

    * Sunday
    * Monday
    * Tuesday
    * Wednesday
    * Thursday
    * Friday
    * Saturday

    You can configure multiple valid hour ranges.

    <Tip>
      <Badge color="green">Happy hours</Badge>

      You can use the **Days of the week** setting to set up a "happy hours" scenario, when members can redeem the reward for a lower point price.
    </Tip>
  </Step>

  <Step>
    ### Metadata

    Add custom attributes for tracking, optimizing, or experimenting.

    You can either:

    * **Use an existing metadata schema**.
    * **Add unknown property**: Metadata that isn't defined and won't be added to the schema.
    * **Add to schema**: Define new metadata schema. Once saved, reload the schema to use the new metadata.

    <Note>
      Read [Metadata](/prepare/metadata) to learn more about custom attributes.
    </Note>
  </Step>

  <Step>
    ### Summary

    Review the reward configuration before saving.

    The summary page displays all configured sections:

    * Details
    * Spendings
    * Timeframe
    * Metadata

    Use **Go to step** to return to a selected section and make changes before saving the reward.

    After reviewing the configuration:

    * Use **Save draft** to save the reward without activating it.
    * Use **Save and activate** to create and activate the reward.
  </Step>
</Steps>

Once saved, the reward is created. It is listed in the **Rewards** section in **Loyalty hub** in the **Draft** or **Active** state.

## Rewards in the loyalty designer

You can create, assign, and manage rewards directly from the loyalty program designer.

### Rewards section

The **Rewards** section in the designer displays all rewards currently assigned to the program.

Each reward card shows:

* Reward name and status
* Reward type and configuration
* Refundable status
* Stock (starting number of available items)
* Connected point wallet and point cost

Use the edit icon to open the reward configuration. Use the unassign icon to remove the reward from the program.

Use the search icon to find rewards by name within the assigned rewards.

Use **+** in the **Rewards** section header to assign an existing reward or create a new one. Creating a new reward opens a simplified builder where you can configure:

* Reward name
* Reward type and digital reward type
* Connected campaign
* Refundable status
* Spending: point wallet and point cost
* Stock

Select **Advanced options** to open the full reward builder with all configuration options, including spendings with conditions, time frame, and metadata.

### Building blocks panel

The **Building blocks** panel lists all rewards available in the loyalty program. The available rewards are the rewards that have spendings that use the point wallets assigned to the program.

In the **Rewards** section of the panel, you can:

* Browse all rewards and their status.
* Search rewards by name using the search field.
* Filter rewards by assignment status using the **All**, **Not assigned**, and **Assigned** tabs.
* Assign or unassign a reward using the link icon.
* Create a new reward using the **+** icon.
* Edit a reward using the edit icon.
* Delete a reward using the delete icon.

Creating a new reward using **+** opens the same simplified builder available in the **Rewards** section. Select **Advanced options** to open the full reward builder.

### Reward assignment

Use the **Quick assign** button to assign the reward to the loyalty program.

The reward builder window will open, where you can edit the reward.

Define the stock limit, which determines:

* **Unlimited stock** (default): There is an unlimited number of rewards that members can redeem.
* **Stock limit**: Members can redeem the defined number of rewards. Once depleted, members can't redeem more rewards.

## Loyalty reward maintenance

In the **Loyalty rewards** list view, use the **three-dot menu** (⋮) on any reward to:

* **Activate** or **Deactivate** the reward: The available action depends on the current status.
* **Assign to program**: Connect the reward to a loyalty program.
* **Edit**: Open the reward configuration.
* **Delete**: Remove the reward permanently.

Select a reward to open its detail view. The detail view contains four tabs:

* **Dashboard**: Shows the reward configuration details and the loyalty programs the reward is assigned to, along with their stock.
* **Spendings**: Shows the spendings configured for the reward.
* **Activity**: Shows a log of events related to the reward, including event name, event ID, group ID, description, and timestamp.
* **Metadata**: Shows the metadata configured for the reward.

Use the edit icon or **Activate**/**Deactivate** button in the detail view header to edit or change the status of the reward.

## Related features

Rewards can be combined with the following features to build more advanced loyalty program flows.

<AccordionGroup>
  <Accordion title="Point wallets">
    Rewards are connected to point wallets through spendings. Learn how to create and manage [point wallets](/build/point-wallet-builder) used in reward spendings.
  </Accordion>

  <Accordion title="Earning rules">
    Learn how to configure [earning rules](/build/loyalty-earning-rule) that define when members earn points they can later spend on rewards.
  </Accordion>

  <Accordion title="Loyalty designer">
    Assign rewards directly to loyalty programs in the [program Designer](/build/create-loyalty-campaign-v2).

    The same reward can be reused across multiple programs.
  </Accordion>
</AccordionGroup>