# VIP Tier benefits

{% hint style="info" %}
This feature is available in **all plans**.
{% endhint %}

### What is "VIP Tiers" feature?

The VIP Tier Block is a visual engagement tool that displays your loyalty program's tier structure and benefits to customers. This feature creates a clear, structured presentation of available tiers and their associated perks, helping customers understand the value of progressing through your loyalty program levels.

### Why do you need this feature?

The VIP Tier block helps merchants enhance customer loyalty by offering a clear and structured way for customers to see the benefits of reaching higher tiers. It not only rewards your most loyal customers but also encourages others to engage more with your store to unlock new rewards. By providing a visual representation of the perks, you increase transparency and motivation for customers to advance in the VIP program, improving retention and satisfaction.

### How perks are managed

The VIP Tier block now pulls its tier list and perks **directly from your VIP Tier program** — the VIP Tier program is the single source of truth. You no longer maintain two separate lists; any change you make to a tier or a perk flows automatically into this block and into the storefront.

{% hint style="info" %}
To add, rename, or remove a perk, go to **Membership** → **VIP Tier** → **Perks**. The block displays an info banner with a shortcut button that takes you straight there.
{% endhint %}

This change applies **by default to new stores**. If you're on an older version of the block and still editing perks inside the block itself, you'll see an **Upgrade now** button in the admin — click it to preview the new layout first, then save to switch.

<figure><img src="/files/AS3eFhqNMXkrs2FYSVrR" alt=""><figcaption></figcaption></figure>

### Free product perks — expandable details

When a perk's reward is a **Free product**, customers previously only saw the label "Free product" without knowing which items they'd receive. The block now includes a small expand control on every free-product perk so customers can open it to see the actual product list.

* Default state: collapsed (clean, scannable overview)
* Clicking the perk expands it inline to reveal the free products
* Applies everywhere the block is rendered — the Joy widget, the loyalty page, and the account page

### How to set up the VIP Tiers block

{% stepper %}
{% step %}
**Configure your tiers and perks first**

Open **Joy Loyalty** → **Membership** → **VIP Tier** and make sure each tier has the perks you want customers to see. This is where you manage everything; the block will reflect whatever is configured here.
{% endstep %}

{% step %}
**Open the block settings**

In Joy Loyalty, navigate to **Embedded content** and select **Set up** on the **VIP Tier block**. Drag and drop tiers to set the display order — the top tier is shown first.
{% endstep %}

{% step %}
**Review perks (read-only)**

Open each tier to review how its perks will appear to customers. You can't edit perks here — use the **Edit in VIP Tier** shortcut at the top of the block if anything needs changing.
{% endstep %}

{% step %}
**Add the block to your theme**

Save your changes, then click **View theme editor**. In the theme editor, add the **Joy: VIP Tier block** and customize colors and description text to match your store. Hit **Save** to publish.

{% embed url="<https://app.arcade.software/share/UfKYG98LIQDuivAYKnOJ>" %}
{% endstep %}
{% endstepper %}

### FAQs

**I'm on the old version and still edit perks inside the block. Will my setup break?**\
No. The previous block behavior continues to work for existing accounts until you choose to upgrade. When you're ready, click **Upgrade now** in the block — you'll see a live preview with the new format before you save. You can back out without losing the previous configuration.

**Can I hide a tier from this block without deleting it from the VIP Tier program?**\
Yes. The display configuration in the block lets you reorder and hide tiers for display purposes only. The underlying VIP Tier program remains unchanged.

**Why does the block show a banner pointing to the VIP Tier program?**\
Because that's where the tier and perk data lives now. The banner makes the shortcut visible so you always know where to go to make changes.


---

# 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://help.joy.so/on-site-content/loyalty-landing-page/vip-tier-benefits.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.