# WPLoyalty - Level Action

Let’s see what the Level Action Add-on is and how to enable it with our WPLoyalty Plugin.

### What is the Level Action Add-on?

The Level Action Add-on allows you to customize how customer levels are determined based on points in your loyalty program. You can choose from different point-based criteria to define the customer levels, making the loyalty program adapt to your business goals and customer journey strategies.

For example:\
If you choose Points Balance, the customer’s level will be determined by their available points. If you choose Earned Points, the customer will be assigned a level based on the total points they have earned, regardless of redemption.

{% hint style="info" %}
Make sure you have already installed and activated the WPLoyalty plugin. Please note that some features explained in this doc are available only in the PRO version.\
Do More with the PRO Version

[Get WPLoyalty PRO](https://wployalty.net/pricing/)
{% endhint %}

Download the add-on from the following link: [Level option add-on](https://wployalty.net/add-ons/level-options/)

**Important Note:**

The Level Action Add-on is supported from WPLoyalty version **1.3.2** and above. Please ensure your plugin is updated.

### How to Enable the Level Action Add-on

#### Step 1: Enable the Add-on

* Navigate to WPLoyalty → Add-ons tab.
* Locate WPLoyalty – Level Action and click to open it.<br>

  <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeE6qdJ0Re0H_NZ3GB2dz6fJYMFagRG3RsNveXora8SPm9iPr0QipLoggA9gGIJ4sjUvBSDOmT2CPrpu70e_8_s80PJ5KIXJS7EljDFv-lv0ZE-l4g_XMIBJ0DMce16xaVNJ0M5Jw?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Level option"><figcaption></figcaption></figure>

#### **Step 2: Configure Settings**

* Go to the Settings tab inside the add-on.
* Choose how you want to determine customer levels:
  * Points Balance
  * Earned Points
  * Redeemed Points
* Click Save Changes after selecting your preferred option.

Screenshot: Settings Tab

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe-ANWQ8DuKYK9BWHlCfYfNzAwk_trRdX1nv9CKdLzbTxq-7DAnmOjVTNFELjV5Q3eC7oIDITth66RHMLnLoDelr0P_LSScLTDfkAxtjobgvH1AzglBn39sQ-AXyBdfB7UfQzcqww?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Level option settings"><figcaption></figcaption></figure>

### How to Configure Levels

Once the Level Action Add-on is enabled, proceed to configure the actual levels under the **Levels** section in WPLoyalty.&#x20;

**Refer to Guide**: [Creating Levels & Badges – WPLoyalty Docs](https://docs.wployalty.net/customers-levels-and-vip/creating-levels-badges)

**Screenshot: Level Configuration**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeLGPr7t2faXKOvW5xtl5G9u38ox3uXGD4kd1fJ9QNlaz042owwpGZbyzm-QQkiAnhMeQQUks1uq2w4HJ5R6OQY2MohpCMR6uZxyAOhQzAvkxdv6E_2RQiMpaeQeuWVrhsqWOZWFQ?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Levels"><figcaption></figcaption></figure>

## Level Criteria Explained:

### Points Balance:&#x20;

When levels are based on Points Balance, the level is determined by the customer’s current available points.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdQtALgCdwszDYmuNioccVrFox3S3SsZRwZbY2ETrhu30bF1WegBggNo7C30L0xXkNVTgH5_ozvgpuG73G8uuRuEesbta2zJp18JEZpUbFT9QvhYyGCUCALLdf5oyQsVJWeRa8nsw?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Level option settings"><figcaption></figcaption></figure>

#### Use case example:

If your business rewards customers based on their current loyalty wallet, this option helps you encourage saving or regular point usage.

**Example**: A customer with 50 points is assigned to "Silver Level", while another with 100 points is placed in "Gold Level".

**Screenshot:**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe_1nksXZAghM1fTM04InQKFCncChT0fV4ERwa43AWP8kyl3bFxMPIP0uVeu9RSN1A0jRtUvj6riNRA7LHu1nQP0uPguyKsYYAUSXAc65zS2J45c-YLNMFyf3i2F_tt1G_KCLcxDQ?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Points and rewards page"><figcaption></figcaption></figure>

### Earned Points:

With this option, levels are calculated based on the total points a customer has earned, regardless of how many they’ve redeemed.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNuWRyoYWAG7enUNEcaI_1geC4cTBwMTHI2cX4q7bIEJpIY1Dkclc959ShM9dFhQ5r6MEvYHFCE-NdT955TqB74ehnn6DsBgZ0nGzROmmJ2pJOrzU-q7fuOTuQlHupZr-cQRLdnQ?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Level option settings"><figcaption></figcaption></figure>

#### Use case example:

Great for businesses that want to reward loyalty over time and recognize long-term customer engagement, even if customers have used up their points.

**Example**: A customer has earned 120 points since joining. Even if they redeemed 80, they still qualify for "Gold Level".

**Screenshot:**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf5epTdhTVBDE_AuZX4VbR0mtgYQG8vNx79CeV9iXH4p9sQWq9e0f28E9ICOEIKp_HsILmbseZTajDeT6lK_fGqD4h1TE9EDFH6WhFglKV5R2peXCXLotCFPv5UF7PduU670off?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Points and rewards page"><figcaption></figcaption></figure>

### Redeemed Points:

In this setup, levels are based on the total points a customer has redeemed.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeU4NNnqhTrGMG32cxPDFtA60OhMgjk53IimVK0bixtYxax53xP4O1KZVK7bFDzFyj-CelXeBw1TzMO3cQg_ZsOukXYWM9kWJNatcznsbTyNxX1McYviI-X530lCIHVoh733I3eZw?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Level option settings"><figcaption></figcaption></figure>

#### Use case example:

Ideal for encouraging active participation and reward redemption, by rewarding customers who frequently use their points.

**Example**: A customer has redeemed 210 points over time and is rewarded with a special "Platinum" level.

**Screenshot:**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeOI4rWs_y4E8zxeZ6cRyKd-oF51NwNZ1lZRErySkP3YN1NnZRlH9m9qrV0Ddnoc-P01tI1UpCVS1iXirlFGtsERFqkT9QapOAvqKqBL1wXxF6_-dnsLKGKCr2lpZUeVPtFZQ8a0w?key=9adQAeWuHJwl0RaUie1Ltl-P" alt="Points and rewards page"><figcaption></figcaption></figure>

This Level Action Add-on provides more control over your loyalty program strategy by letting you decide how levels should be awarded. Whether you want to reward active participation, high earners, or long-term loyalty, this add-on has you covered.

### **Video:**

{% embed url="<https://youtu.be/iuXiHZ63lNQ>" %}

**Still unclear ?**&#x20;

Please submit a [support request](https://wployalty.net/support/). We are always happy to assist you :)

\ <br>


---

# Agent Instructions: 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.wployalty.net/wployalty-level-action.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.