> 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/loyalty-program.md).

# Loyalty Program

Settings for your loyalty program.

In this section, you can set up various earning rules and redeeming rules for your loyalty program.

### Adding perks

New perks can be added using the + buttons in each section. View the different earning rules and redeeming rules above for instructions on creating new perks.

### Organizing earning rules

Use [categories and display order](https://docs.perkville.com/features/settings/loyalty-program/organizing-earning-rules.md) to group related earning rules and choose how customers see them.

### Finding and copying a Perk ID

Each earning or redeeming rule has a **Perk ID**. You can find the labeled ID in the **Loyalty Program** settings list and on the perk's edit page. Use the adjacent **Copy** button to copy the ID rather than transcribing it.

A Perk ID identifies the specific rule you are discussing. You may be asked to share it when contacting [Perkville Support](https://docs.perkville.com/overview/support.md) about an earning or redemption rule or when working with an integration developer to map activity to a perk. Include the business and location context when relevant; the ID alone does not describe how the rule is configured.

### Editing perks

To edit a perk, select its name from the **Loyalty Program** page. Update the available fields, then select **Save**. When Perkville presents a confirmation summary of the proposed changes, review it before confirming the save.

The fields vary by perk type. They can include the name, description, point value, eligible locations, availability, and display order.

{% hint style="info" %}
Only Admins can manage program rules and settings. Location-restricted Admins can only edit perks for their assigned locations.
{% endhint %}

#### Before changing rules used by an integration

If your business awards points through an integration (including one using Middle), review the rule change with the person responsible for your integration before putting it into use:

1. Identify the earning activity or perk being changed and which locations it applies to.
2. Confirm whether your integration sends activities to this existing perk or has separate mappings or calculations that may need to change.
3. Check whether the change affects point values, eligibility, identifiers, or activity names used by the integration.
4. Test a representative transaction and verify the expected result before relying on the updated configuration for customers.

Not every points-value edit requires an integration change: it depends on how that integration maps and awards activities. Contact [Perkville Support](https://docs.perkville.com/overview/support.md) if you are unsure.

#### Viewing perk change history

Perkville records changes to loyalty-program perks so administrators can review how program configuration changed over time. You can view the history for an individual perk or review changes across the program, filter the history, and export it as CSV.

See [Loyalty Program History](https://docs.perkville.com/features/settings/loyalty-program/loyalty-program-history.md) for instructions and details about what is tracked.

### Locking perk locations

Admins with access to all locations can set the eligible locations and lock those locations. This will prevent admins without access to all locations from removing or otherwise modifying the locations for the perk. Any admin with access to all locations can lock/unlock a perk's locations.

### Deactivating perks

Certain perks can be deactivated when you no longer want to use them in your loyalty program.

To deactivate a perk, use the minus button next to a perk or offer to deactivate it. You may also use the Active toggle on the perk's edit page to deactivate it (be sure to hit Save).

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FkGGm2wUkOrAHl4z2W9xW%2FScreenshot%202026-06-22%20at%205.34.43%E2%80%AFPM.png?alt=media&#x26;token=9d4b9412-d6b7-4759-9922-aa7bfc66e4a8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FmdtpAkJq6qvcmP47aaNf%2FScreenshot%202026-06-22%20at%205.35.36%E2%80%AFPM.png?alt=media&#x26;token=f23682ca-3e7e-4aa2-9920-3ddfbd4929ff" alt=""><figcaption></figcaption></figure>

Deactivated perks will show up in the **Recently Deactivated Perks** section at the bottom of the Loyalty Program settings tab.

{% hint style="info" %}
This section will only return the last 10 modified perks.
{% endhint %}

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FY3w17mpZgoyGDFbg0HTF%2FScreenshot%202026-06-22%20at%205.36.45%E2%80%AFPM.png?alt=media&#x26;token=2b186676-f5ef-46ed-8d20-f93b3a2d61db" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
[Managing active and inactive referral rules and offers](https://docs.perkville.com/features/referrals/managing-active-and-inactive-referral-rules-and-offers.md) explains the specific guidelines for deactivating **referrals**.
{% endhint %}

### Reactivating perks

If you would like to reactivate a perk, you can reactivate eligible perks from the Recently Deactivated Perks section.

If applicable, a perk can be reactivated by clicking on the green plus sign next to it. You may also use the Active toggle on the perk's edit page to reactivate it (be sure to hit Save).

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FBu1ionckKuPW1u79Iq8T%2FScreenshot%202026-06-22%20at%205.38.36%E2%80%AFPM.png?alt=media&#x26;token=aee1f600-9372-4c77-a80a-26d77fa90db1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FQ4B32RfprrW8pa8gZe1U%2FScreenshot%202026-06-22%20at%205.38.56%E2%80%AFPM.png?alt=media&#x26;token=9f468e81-c194-4f21-99e6-e4eba84a1a91" alt=""><figcaption></figcaption></figure>

Certain perks cannot be reactivated, such as Frequency Bonuses, Time Bonuses, and others. These perks will be indicated with the help text.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2F8F4p4ldQOZIC8ubl8vpg%2FScreenshot%202026-06-22%20at%205.40.50%E2%80%AFPM.png?alt=media&#x26;token=67927ca8-9baf-482b-b439-b43b2cd3dda5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
[Managing active and inactive referral rules and offers](https://docs.perkville.com/features/referrals/managing-active-and-inactive-referral-rules-and-offers.md) explains the specific guidelines for reactivating **referrals**.
{% endhint %}

Some perks, such as birthday perks or location-based perks, may only have one active perk at a time. If you try to reactivate a perk and one already exists, you will receive a warning before overriding.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FWZ0NH2re9ebX0pVRNt4i%2FScreenshot%202026-06-22%20at%205.41.14%E2%80%AFPM.png?alt=media&#x26;token=1e0130ab-0541-4848-b3d8-fdbb636880a0" alt=""><figcaption></figcaption></figure>

### Expired perks

Some perks that are set up for time periods may expire at the end of the period.

These will *not* show up in the Recently Deactivated Perks section unless they have been deactivated.

To show expired perks, check the box next to "Show expired perks?" and hit **Filter**.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2F0qUPcoajHNI471ba2Hz1%2FScreenshot%202026-06-22%20at%205.33.51%E2%80%AFPM.png?alt=media&#x26;token=16b2f22d-e390-4dae-96a5-58ed51dbad25" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Continue reading**

Customize the names and descriptions on your program pages. **Start with** [**Custom settings**](https://docs.perkville.com/features/settings/loyalty-program/custom-settings.md) **→**
{% endhint %}


---

# 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/loyalty-program.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.
