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
`tierwise-member`	Everyone who holds a tier right now.
`tierwise-<tier name>`	Their current tier only, for example `tierwise-silver`. Built from the tier's name.
`tierwise-lapsed`	Past members who hold no tier now.

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

One tag on orders

If a tier gives a gift, the order that takes a customer into that tier is tagged tierwise-gift-<tier name>, for example tierwise-gift-silver, so you know which orders to pack a gift with. It is the only tag TierWise puts on an order, and it is never removed.

Your own tags are safe

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

wholesalenewslettertierwise-membertierwise-goldvip-2024

Don't add or remove tierwise- tags by hand. TierWise's records are the source of truth, and the next update puts back whatever the customer's orders say. To give someone a higher tier yourself, use Change tier on their page in the app; see Setting a tier by hand.

Using tags

In a customer segment:

customer_tags CONTAINS 'tierwise-gold'

In your theme's Liquid:

{% if customer.tags contains 'tierwise-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. A customer who has never earned a tier and hasn't ordered this year has no values yet; they're filled in with their first qualifying order.

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

A field that no longer applies is removed rather than left behind: a lapsed customer has no tierwise.tier, and a customer with no codes has no tierwise.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 reward reminder work.

Shop metafield

tierwise.program on your shop holds your tier names and thresholds, which tiers get a birthday gift, and the spend between reward codes, which is how the Rewards page shows them. It's updated every time you save Settings.