# Tiered Categories

**Tiered Categories** allow you to create a subscription model where customers can select from multiple levels of membership—such as **Bronze**, **Silver**, or **Gold**—and automatically receive the benefits of all lower tiers.

> *Example: A Gold subscriber receives the perks from Bronze and Silver as well.*

***

###  Requirements and Limitations

* **Tiers are not currently supported for Minecraft store types.**
* If you're using a **custom or legacy template**, please follow [this guide](https://docs.tebex.io/developers/templates/guides/supporting-tiers-on-custom-store-templates) to ensure tier support is implemented properly.

***

### How to Set Up Tiered Categories

Tiers are configured by creating a **Category** in your Tebex Creator Panel that contains only your tiered packages.

#### **Step-by-Step Setup**

1. Go to **Packages** → **Add New** → **Category**.
2. In the **General** tab, enable **“Tiers”** for this category.
3. Add packages representing each tier level (e.g., Bronze, Silver, Gold).
   * *All packages must use the **same billing cycle** (e.g., monthly, quarterly).*

***

### Configuring Tier Deliverables

Each package in a tier should include **deliverables**, which are the actions triggered during the subscription lifecycle.

| Trigger                           | Purpose                                               |
| --------------------------------- | ----------------------------------------------------- |
| **When the package is purchased** | Grant the perks for the tier.                         |
| **When the subscription renews**  | Reapply any recurring perks.                          |
| **When the package is removed**   | Revoke the perks if a customer downgrades or cancels. |

> Deliverables are **cumulative**. A customer upgrading to Gold will receive all perks from Bronze, Silver, and Gold in one transaction.

***

### Tier Logic: Examples

* **Example A**: Buying **Gold** directly triggers the **purchase deliverables** for **Bronze**, **Silver**, and **Gold**.
* **Example B**: Upgrading from **Bronze → Gold** triggers deliverables for **Silver** and **Gold** only.
* **Example C**: Downgrading from **Gold → Silver** triggers **removal deliverables** for **Gold**.

***

### Upgrades

* Upgrades are processed **immediately**.
* The customer is **charged a prorated amount** for the remaining time between their current tier and the new tier.
* All new deliverables are triggered upon upgrade.

***

### Downgrades

* Downgrades occur at the **end of the current billing cycle**.
* On downgrade, Tebex triggers any **removal deliverables** associated with the higher tier being exited.