> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/introduction.md

## Article Content:

# Introduction

The Loyalty Tiers API allows you to create a levels-based program that assigns loyalty accounts to different tiers based on the amount of points they have earned.  

With the Loyalty Tiers API, you can:
- [Create](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/create-tier.md) and [update](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/update-tier.md) individual tiers.
- [Create](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/create-tiers-program-settings.md) and [update](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/update-tiers-program-settings.md) settings that apply globally to the tiers program.
- Retrieve [specific tiers](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/get-tier.md), [all tiers](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/list-tiers.md), or the [tier program settings](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/get-tiers-program-settings.md).

For more information about loyalty tiers, see [Adding Tiers to Your Loyalty Program](https://support.wix.com/en/article/wix-loyalty-program-adding-tiers-to-your-loyalty-program).  

## Before you begin  

It's important to note the following points before starting to code:
- A site must have a [Plus plan](https://support.wix.com/en/article/wix-studio-upgrading-sites) (Wix Studio) or a [Business plan](https://support.wix.com/en/article/choosing-a-premium-plan?tabs=Business) (Wix Editor) to add tiers.
- A site must have at least one of these apps: Wix Bookings, Wix Events, Wix Pricing Plans, or Wix Stores.
  >**Note:** Currently, tiers can't be added to Wix Restaurants loyalty programs.
- The tiers program `status` must be manually set to `ACTIVE`. Call [Update Tiers Program Settings](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/update-tiers-program-settings.md) to update the `status` or enable tiers from a Wix user's [dashboard](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Fdashboard%2F%7BmetaSiteId%7D%2Floyalty-accounts%2Fmanage%3Ftab%3Dpoints-and-rewards&title=Select+a+Site&primaryButtonText=Select+Site).

## Use cases

- [Create tier-specific shopping experiences](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/sample-use-cases-and-flows.md)

## Terminology  

- **Tiers program settings:** Settings that apply globally to the overall tiers program.  
- **Base tier:** A default tier for any loyalty account that's unassigned for not meeting the required points threshold of any other tier. The base tier requires `0` points, has no `tierId`, and isn't returned as a tier when [List Tiers](https://dev.wix.com/docs/api-reference/crm/loyalty-program/loyalty-program-management/tiers/list-tiers.md) is called. When a tiers program status is `PAUSED` or `DISABLED` all of the loyalty accounts are assigned to the base tier.
- **Rolling window:** Period of time used to calculate loyalty points for tier assignment. The total points earned and adjusted during this period determine if the account meets a tier's required point threshold. The window recalculates every 15 minutes or if a new tier event triggers.
- **Points earned and adjusted:** Tier assignment is based on the total amount of loyalty points earned and adjusted over the period of time in a `rollingWindow`. If an account redeems points during that period, the points that were earned still count towards tier assignment even if that leaves the remaining points balance below the tier's required point threshold. Similarly, if the current points balance for a loyalty account is above a tier's required points threshold, but those points were earned in a time period earlier than the `rollingWindow` then those points aren't considered for tier assignment.

@sdk_package_setup