> 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

Challenges support rewards for individual requirements as well as a final reward for completing or participating in the challenge. Each reward can contain points, [instant rewards](https://docs.perkville.com/features/redeeming-rules/instant-rewards.md), or both.

{% hint style="info" %}
**No manual Join required with automatic enrollment**

Enable **Automatically enroll eligible customers** in the challenge settings before launching. An eligible customer's first qualifying activity enrolls them and counts toward progress. They can earn configured milestone rewards as they reach each goal without selecting **Join**. [See automatic enrollment setup](https://docs.perkville.com/features/challenges/automatic-enrollment-into-challenges.md).
{% endhint %}

| Reward                                                    | When it is earned                                                      | Where to configure it                                                       |
| --------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Requirement completion reward (optional milestone reward) | An enrolled customer completes an individual requirement.              | Add or edit the Challenge Progress Activity.                                |
| Challenge completion reward (mandatory)                   | An enrolled customer completes all challenge requirements.             | **Add Reward for Completing** on the challenge settings page.               |
| Participation reward (optional)                           | An enrolled customer participates but does not complete the challenge. | **Add Reward for Participating (Optional)** on the challenge settings page. |

## Requirement completion rewards

Milestone rewards let customers earn something along the way. For example, a requirement to attend five classes could award 25 points and a free smoothie. The customer does not need to complete the other requirements first.

On the progress activity form, enable **Award a reward when this goal is reached**, then choose points, instant rewards, or both. See [Challenge Progress Activities](https://docs.perkville.com/features/settings/challenges/challenge-progress-activities.md) for the steps.

* Each requirement's milestone reward is awarded once per customer for that requirement, not once per qualifying activity.
* Customers must be enrolled and complete the requirement. **With automatic enrollment enabled, no Join click is needed:** the first qualifying activity enrolls an eligible customer and counts toward their milestone goals.
* If qualifying progress has already completed the requirement when an eligible customer joins an active challenge, its configured reward can be awarded at joining.
* Adding or editing a milestone reward after an enrolled customer has completed the requirement does not trigger a retroactive payout or reissue an already awarded reward.

## Challenge completion reward

This is the final reward for an enrolled customer who completes all requirements. Configure it separately from the milestone rewards. Customers can receive both the rewards for their individual requirements and the final completion reward.

Points are credited to the customer's account. Issued instant rewards are available on the customer's [vouchers](https://docs.perkville.com/features/vouchers.md) page.

See [Challenges](https://docs.perkville.com/features/challenges.md) for completion timing and the rules for qualifying backdated activity.

## Participation reward

The optional participation reward is for enrolled customers who participate but do not complete the challenge. It is distributed within three days after the challenge ends.

A customer does not receive both the final completion reward and the participation reward. Milestone rewards are separate: a customer can earn a milestone reward and still qualify for the participation reward if they do not finish the entire challenge.

## Understanding progress and rewards

Completing a requirement and receiving a reward are different events. With manual enrollment, a customer can have recorded progress before selecting **Join**, but progress alone does not award a milestone reward. The challenge page shows **Join to earn** for completed requirements awaiting enrollment. With automatic enrollment enabled, an eligible customer's first qualifying activity enrolls them, so a separate **Join** action is not required.

The final challenge reward is displayed separately from the requirement rewards. A challenge completion date describes when the challenge was completed; it is not a voucher delivery timestamp.

If a customer believes a reward is missing, check their enrollment, recorded progress, points history, and vouchers. Contact [Perkville Support](https://docs.perkville.com/overview/support.md) if the reward is still missing.


---

# 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/settings/challenges/challenge-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.
