> 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/settings/challenges/challenge-rewards.md).

# Challenge Rewards

Perkville's challenge feature allows you to set up rewards to incentivize and recognize customer engagement. There are two types of rewards you can offer for a challenge:

#### 1. Reward for Completing the Challenge (Mandatory)

* **Description**: This reward is given to participants who join and successfully complete the challenge. It serves as the primary incentive for completing the challenge.
* **Reward Options**: You may choose between awarding points or [instant rewards](/features/redeeming-rules/instant-rewards.md).
  * **Points:** The reward can be specified as a number of points (e.g., 500 points). Points are credited to the customer's account upon completion of the challenge.
  * **Instant Reward**: Alternatively, the reward can be any number of instant rewards. Instant rewards will be emailed to the customer upon completing the challenge and will be accessible on the customer's [vouchers](/features/vouchers.md) page.

#### 2. Reward for Participating (Optional)

* **Description**: This optional reward is offered to customers who join the challenge but do not complete it. It acts as a token of appreciation for their participation, even if they don't meet all the challenge requirements.
* **Reward Options** : Like the completion reward, you may choose between awarding points or instant rewards.
  * **Points**: This optional reward can also be specified as a number of points (e.g., 20 points). This reward is given to participants who join the challenge but fall short of completing it by the end of the challenge.
  * **Instant Reward**: Alternatively, the optional reward can be any number of instant rewards. Instant rewards will be emailed to the customer if they do not complete the challenge in time. The reward(s) will be accessible on the customer's [vouchers](/features/vouchers.md) page.

#### Notes on Rewards

* **Completion Reward**: This reward is mandatory and must be set for every challenge. It will be distributed to those who meet all the challenge requirements.
* **Participation Reward**: This reward is optional and will only be distributed if a customer joins the challenge but does not complete it. It is intended to acknowledge their effort and encourage continued engagement.

By offering these rewards, you can motivate customers to fully engage with your challenges and recognize their efforts even if they don't fully meet the challenge criteria.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perkville.com/features/settings/challenges/challenge-rewards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
