# 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.


---

# 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.tebex.io/creators/tebex-control-panel/how-to-create-packages/tiered-categories.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.