> ## 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 benefits

> Configure a reusable benefit for loyalty earning rules

Benefits define rewards that can be awarded through loyalty earning rules.

Go to **Loyalty hub** > **Benefits**.

From the **Benefits** view, you can:

* View all existing benefits and their status
* Open benefits to review their configuration
* Search benefits using the search bar
* Filter benefits using **Add filter**
* Reload the benefits list using **Reload**
* Create benefits using **+ Create benefit**
* Activate, edit, or delete benefits using the **⋮** actions menu

## Prerequisites for creating benefits

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

Depending on the benefit type, you may need:

* A point wallet for point-based benefits.
* Products or SKUs for material benefits.
* Gift voucher or discount coupon campaigns for digital benefits.
* Metadata schemas for metadata-based proportional points.
* Custom event schemas for metadata values based on custom events.

<Note>
  Some resources can be created directly from the builder using the **+** icon. SKUs, gift voucher campaigns, and discount coupon campaigns cannot be created from the benefit builder.
</Note>

## Create a benefit

Benefits are configured in a multi-step builder.

You can use **Save draft** and complete the configuration later.

Go to **Loyalty hub** > **Benefits** and use **+ Create benefit**.

<Steps>
  <Step>
    ### General settings

    Configure the benefit name and stock.

    Enter the benefit name in **Name benefit**.

    By the default, the stock checkbox is set to **Unlimited stock**. Uncheck it and enter the **Stock limit**, which defines how many times the benefit can be issued.
  </Step>

  <Step>
    ### Configuration

    Select the benefit type and configure its details.

    Supported benefit types:

    * **Points**
    * **Material**
    * **Digital**

    <Tabs>
      <Tab title="Points">
        Use **Points** to create a point-based benefit.

        In **Points configuration**, select how points are awarded.

        #### Fixed points

        Use **Fixed** to award the same number of points each time the benefit is applied.

        You can create a new point wallet directly from the builder using the **+** icon.

        Configure the following fields:

        * **Point wallet**: Selects the point wallet that receives the points.
        * **Point value**: Number of points awarded.

        #### Proportional points

        Use **Proportional** to calculate points from order values, item quantities, or metadata values.

        Configure the following fields:

        * **Calculation type**: Defines the value used to calculate points.
        * **Card definition**: Selects the wallet that receives the points.
        * **Points**: Number of points awarded for the selected value

        Calculation methods are grouped by type.

        <AccordionGroup>
          <Accordion title="Order amount calculations">
            Use order amount calculations to award points based on total order values.

            Available order amount calculations:

            * **Pre-discount order amount**: Uses the total order amount before discounts are applied. Configure **Points** and **Amount**.
            * **Post-discount order amount**: Uses the total order amount after discounts are applied. Configure **Points** and **Amount**.
          </Accordion>

          <Accordion title="Order item calculations">
            Use order item calculations to award points based on selected order items.

            Use **Applicable to** to select products, SKUs, or product collections included in the calculation. You can create a new product or product collection directly from the builder using the **+** icon.

            Available order item calculations:

            * **Pre-discount order items amount**: Uses selected order item values before discounts are applied. Configure **Points**, **Amount**, and **Applicable to**.
            * **Post-discount order items amount**: Uses selected order item values after discounts are applied. Configure **Points**, **Amount**, and **Applicable to**.
            * **Order items quantity**: Uses the quantity of selected order items. Configure **Points**, **Amount**, and **Applicable to**.
          </Accordion>

          <Accordion title="Metadata calculations">
            Use metadata calculations to award points based on metadata values.

            You can create a new metadata property directly from the builder using the **+** icon.

            Available metadata calculations:

            * **Customer metadata value**: Uses a selected customer metadata property. Configure **Points**, **Value**, and **Metadata property**.
            * **Order metadata value**: Uses a selected order metadata property. Configure **Value** and **Metadata property**.
            * **Custom event metadata value**: Uses a selected custom event metadata property. Configure **Value** and **Metadata property**.
          </Accordion>
        </AccordionGroup>
      </Tab>

      <Tab title="Material">
        Use **Material** to create a benefit based on a product or SKU.

        In **Material configuration**, select the source item.

        #### Product

        Use **Product** to select one product as the benefit.

        You can create a new product directly from the builder using the **+** icon.

        #### SKU

        Use **SKU** to select a specific product variant as the benefit.

        SKUs cannot be created from the benefit builder.
      </Tab>

      <Tab title="Digital">
        Use **Digital** to create a benefit based on an existing voucher campaign.

        In **Digital configuration**, select the voucher type.

        #### Gift vouchers

        Use **Gift voucher campaign** to select a gift voucher campaign.

        In **Balance**, enter the credit balance added to the gift voucher.

        <Note>
          The balance adds credits to the gift voucher. If a new gift voucher is issued as a benefit, the value in **Balance** will be added to the initial value of the gift voucher as defined in the gift card campaign.
        </Note>

        #### Discount coupons

        Use **Discount coupons** to select a discount coupon campaign.

        The benefit will issue a voucher from the selected campaign.
      </Tab>
    </Tabs>
  </Step>

  <Step>
    ### Summary

    Review the benefit configuration before saving.

    The summary page displays all configured sections:

    * **General settings**
    * **Configuration**

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

    After reviewing the configuration:

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

Once saved, the benefit is listed in **Benefits** in **Loyalty hub**.

You can select it in the **Benefit** effect when configuring an **earning rule**.
