> 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/referrals/configuring-your-referral-program/referral-reward-eligibility-window.md).

# Referral reward eligibility window

You can set a referral reward eligibility window to define how long a submitted referral is eligible to earn a reward.

After the eligibility window ends, the referral will still exist in Perkville and its completion will still be tracked, but it will no longer earn a reward.

### Configure the eligibility window

1. From your business dashboard, go to **Reward Program**.
2. Scroll to **Earning Activities**.
3. Find your referral earning activity and click **Edit**.
4. In the **Referral reward eligibility window (days)** field, enter the number of days a submitted referral should be eligible to earn a reward.
5. Optional: In the **Referral eligibility explanation** field, enter a message customers will see explaining how long their referral is eligible to earn a reward and the criteria to earn a reward.
6. Optional: Use **Backdate referral expiration** to determine whether existing referrals should be updated with the expiration rule.
7. Click **Save**.

### Referral reward eligibility window

The **Referral reward eligibility window (days)** field controls how many days a submitted referral is eligible to earn a reward after it is created.

For example, if you enter **90**, the referred friend must [complete the required action](/features/referrals/completing-a-referral.md) within 90 days of the referral being submitted for the referring customer to qualify for the reward.

After the eligibility window ends, the referral can still exist, but it will no longer earn a reward.

### Backdate referral expiration

The **Backdate referral expiration** setting determines whether existing referrals should be updated when you save the eligibility window.

If **Yes** is selected, Perkville will update the expiration date of existing referrals. This update will happen within the next 24 hours.

If **No** is selected, existing referrals will keep their current expiration date.

### Notes

If you leave the **Referral reward eligibility window (days)** field blank, referrals will not expire based on this setting.

Review the customer-facing explanation before saving your changes so customers understand when a referral qualifies for a reward.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-reward-eligibility-window.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.