> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lantern.is/llms.txt
> Use this file to discover all available pages before exploring further.

# loyalty_tier

> Access the current loyalty tier handle for a logged-in customer.

## Syntax

<Tabs>
  <Tab title="Liquid">
    ```liquid theme={null}
    customer.metafields.lantern.loyalty_tier
    ```
  </Tab>
</Tabs>

## Description

The `loyalty_tier` metafield contains the customer's current loyalty tier as a string handle. Tiers represent different levels of customer status based on spending, points earned, or other qualifying criteria. This value is automatically updated when customers advance or change tiers.

<Info>
  Tier handles are lowercase, hyphenated strings (for example `bronze`, `silver`, `gold`) that correspond to your loyalty program's tier configuration.
</Info>

## Properties

**Type:** `String`
**Namespace:** `lantern`

## Return Values

| Scenario                 | Value                        | Type   |
| ------------------------ | ---------------------------- | ------ |
| Logged in with tier      | Tier handle (e.g., `"gold"`) | String |
| Logged in without tier   | `null`                       | null   |
| Not eligible for loyalty | `null`                       | null   |
| Logged out               | `null`                       | null   |

## Examples

### Basic Tier Display

```liquid theme={null}
{% assign tier = customer.metafields.lantern.loyalty_tier %}
{% if tier %}
  <div class="loyalty-tier">
    <span class="tier-badge tier-{{ tier }}">
      {{ tier | capitalize }} Member
    </span>
  </div>
{% endif %}
```

### Tier-Based Messaging

```liquid theme={null}
{% assign tier = customer.metafields.lantern.loyalty_tier %}
{% if tier %}
  <div class="tier-welcome">
    {% case tier %}
      {% when 'bronze' %}
        <h3>Welcome Bronze Member! 🥉</h3>
        <p>You're earning 1 point per $1 spent.</p>
      {% when 'silver' %}
        <h3>Welcome Silver Member! 🥈</h3>
        <p>You're earning 1.5 points per $1 spent.</p>
      {% when 'gold' %}
        <h3>Welcome Gold Member! 🥇</h3>
        <p>You're earning 2 points per $1 spent plus free shipping!</p>
      {% when 'platinum' %}
        <h3>Welcome Platinum Member! 💎</h3>
        <p>You're earning 3 points per $1 spent plus exclusive access!</p>
      {% else %}
        <h3>Welcome {{ tier | capitalize }} Member!</h3>
    {% endcase %}
  </div>
{% endif %}
```