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

> Access the current period spending amount for tier progression tracking.

## Syntax

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

## Description

The `loyalty_spend` metafield contains the customer's spending amount for the current tier period. This value tracks spending toward tier advancement or maintenance and resets based on your loyalty program's tier period configuration (monthly, yearly, or lifetime).

<Info>
  Spend tracking periods vary by loyalty program configuration. Common periods include annual (January-December), rolling 12 months, or lifetime spending.
</Info>

## Properties

**Type:** `Number`
**Namespace:** `lantern`

## Return Values

| Scenario                   | Value                            | Type   |
| -------------------------- | -------------------------------- | ------ |
| Logged in with spending    | Spending amount (e.g., `450.50`) | Number |
| Logged in without spending | `0`                              | Number |
| Not eligible for loyalty   | `null`                           | null   |
| Logged out                 | `null`                           | null   |

## Examples

### Basic Spend Display

```liquid theme={null}
{% assign spend = customer.metafields.lantern.loyalty_spend %}
{% if spend != nil %}
  <div class="loyalty-spending">
    <h4>Period Spending</h4>
    <span class="spend-amount">${{ spend | money_without_currency }}</span>
  </div>
{% endif %}
```