Your store

Tags & metafields

TierWise keeps every member's status on the customer record in Shopify, so segments, discounts, Flow and your theme can use it without any extra app.

Customer tags

Tag	Who has it
`loyalty-member`	Everyone who holds a tier right now.
`loyalty-<tier name>`	Their current tier only, for example `loyalty-silver`. Built from the tier's name.
`loyalty-lapsed`	Past members who hold no tier now.

A member has two tags: loyalty-member and their tier. A lapsed customer has only loyalty-lapsed. A customer who never qualified has none.

Your own tags are safe

TierWise only ever adds or removes tags that start with loyalty-. Anything else on a customer is never read, changed or removed.

wholesalenewsletterloyalty-memberloyalty-goldvip-2024

Don't add or remove loyalty- tags by hand. TierWise's records are the source of truth, and the next update puts back whatever the customer's orders say.

Using tags

In a customer segment:

customer_tags CONTAINS 'loyalty-gold'

In your theme's Liquid:

{% if customer.tags contains 'loyalty-gold' %}
  Welcome back, Gold member.
{% endif %}

Customer metafields

All in the loyalty namespace. TierWise creates the definitions during your first sync, so the fields are visible on each customer in your admin.

Metafield	Type	Holds
`loyalty.tier`	Text	The current tier's position, `tier-1`, `tier-2` or `tier-3`. Stays the same when a tier is renamed.
`loyalty.ytd_net_spend`	Decimal	Spend so far this calendar year.
`loyalty.amount_to_next_tier`	Decimal	Spend still needed for the next tier. `0` at the top tier.
`loyalty.joined_at`	Date	The day of the order that first put them in a tier.
`loyalty.reward_codes`	JSON	Unused, unexpired codes: code, label such as "15% off", and expiry.

A field that no longer applies is removed rather than left behind: a lapsed customer has no loyalty.tier, and a customer with no codes has no loyalty.reward_codes.

Every field can be read by your theme for the signed-in customer only, which is how the Rewards page block and the storefront bar work.

Shop metafield

loyalty.program on your shop holds your tier names, thresholds and Rewards page wording. It's updated every time you save Settings.