> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/redeeming-rules/custom-rewards.md).

# Custom rewards

## Accessing Custom Rewards

To create custom rewards, follow these steps:

1. From the Dashboard, navigate to **Loyalty Program** in the left-hand navigation.
2. Click on the **+** sign next to **Rewards**.
3. Select **Custom** from the dropdown menu.

## Creating Custom Rewards

When creating custom rewards, you can enter the following fields:

* **Points:** Enter the number of points the reward costs in the first field.
* **Name:** Enter the name of the reward.
* **Customer-facing name:** Optionally enter a different name for customers. This name appears on customer-facing loyalty program pages and in applicable emails.
* **Description:** Enter the description of the reward.
* **Fine Print:** Enter any fine print for the reward.
* **Photo:** Add a photo for the reward. The form accepts JPEG images with a minimum size of 350 x 200 pixels.

## Restricting who can redeem a Custom Reward

Custom Rewards include several controls that can limit where, when, or by whom a reward can be redeemed:

* **Locations:** Select the locations where the reward can be redeemed.
* **Required Attributes:** Require customers to have a specific [custom attribute value](https://docs.perkville.com/features/customers/custom-attributes.md) to redeem the reward. For example, a business could create a custom attribute for a customer segment such as **VIP** and restrict a reward to customers with that value.
* **Restrict Levels:** Require the customer to have a specific [level](https://docs.perkville.com/features/levels.md) to redeem the reward.
* **Limit Redemptions:** Set limits on how often a customer can redeem the reward, such as once per month.
* **Available Date Range:** Specify when the reward will be available for redemption.

{% hint style="info" %}
The [Only active members can participate in the rewards program](https://docs.perkville.com/features/settings/memberships/settings.md) setting is a program-wide participation restriction, not an individual reward restriction. If you want to target a specific Custom Reward to a subset of customers, use options such as **Required Attributes** or **Restrict Levels**.
{% endhint %}

## Limiting how often a customer can redeem a reward

Use **Limit Redemptions** when you want to control how many times each customer can redeem a Custom Reward during a defined period. For example, you can configure a reward so that each customer can redeem it once per month.

If a customer believes a reward should be available again but cannot redeem it, check the following:

1. **Confirm the reward and location:** Make sure you are reviewing the same Custom Reward and location the customer is trying to use.
2. **Review the redemption limit:** Check the configured redemption count and period to determine whether the customer has already reached the limit for the current period.
3. **Check the available date range:** Confirm that the reward is currently available.
4. **Review other eligibility restrictions:** Check any Required Attributes, Restrict Levels, location restrictions, and program-wide membership participation settings that may apply.
5. **Review prior redemptions and vouchers:** Check the customer's history to confirm prior redemptions and whether an existing voucher is still active, used, or expired. See [Voucher statuses](https://docs.perkville.com/features/redeeming-rules/custom-rewards/voucher-statuses.md) for more information.

If the configuration and customer history indicate the reward should be available but it still cannot be redeemed, contact Perkville Support with the customer, reward, and location details.

## Additional display options

* **Hide Perk:** Toggle to hide the reward from the user interface.
* **Display Order:** Choose the order in which the reward is displayed.

## Voucher Options

Custom rewards generate vouchers for customers to redeem. Customize voucher settings to suit your business needs:

* **Days Before Expiration:** Determine how many days the customer has to use the voucher before it expires.
* [**Initial Voucher Status**](https://docs.perkville.com/features/redeeming-rules/custom-rewards/voucher-statuses.md)**:** Set the status of the voucher when it is issued.
* **Redemption Instructions:** Provide instructions to customers on how to redeem the reward. Examples are provided based on the initial voucher status selected.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/features/redeeming-rules/custom-rewards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
