Customer Object

The customer metafield contains the individual loyalty data for a single customer. Access it in Liquid at:

{{ customer.metafields.mage.loyalty.value }}

Since the metafield type is json, you access nested properties through .value in Liquid. This metafield is only available on pages where the customer object exists (i.e. the customer is logged in).

Full object shape

{
  "points_balance": 1250,
  "lifetime_points": 3400,
  "redeemed_points": 2150,
  "vip_tier": "Gold",
  "status": "member",
  "points_next_expiry_at": "2026-12-31T00:00:00.000Z"
}

Field reference

Field	Type	Description
`points_balance`	number	Current available points the customer can spend
`lifetime_points`	number	Total points earned since joining the program
`redeemed_points`	number	Total points spent on rewards
`vip_tier`	string	Name of the customer’s current VIP tier, or an empty string if they have no tier
`status`	string	`"member"` or `"excluded"`
`points_next_expiry_at`	string \| null	ISO 8601 date when the customer’s next points expire. Populated only when the shop uses `last_purchase_date` expiry and the customer has made a purchase; otherwise `null`

Status values

Value	Description
`member`	Active loyalty program member
`excluded`	Customer has been excluded from the loyalty program by the merchant

Shop Object Basics

REST API

API Resources

Webhook Events

Shopify Metafields

Full object shape

Field reference

Status values

​Full object shape

​Field reference

​Status values

Full object shape

Field reference

Status values