Overview

TrustWILL can sync customer loyalty data to Shopify Customer Metafields. After syncing, merchants can use loyalty data inside Shopify Admin, Customer Segments, Shopify Flow, theme Liquid, cart drawer, product pages, and supported third-party apps.

What This Feature Does

When enabled, TrustWILL will write each customer’s loyalty data into Shopify customer metafields.

This allows Shopify and the storefront theme to read loyalty information such as:

Whether the customer is a loyalty member
The customer’s points balance
The customer’s current tier name

Plan Availability

This feature is available for merchants on the Growth plan and above.

The data can then be used to personalize storefront content, build Shopify customer segments, trigger Shopify Flow automations, or show rewards information in the cart and account pages.

Metafield Naming

TrustWILLloyalty metafields are app-owned and read-only. Because these metafields are managed by the TrustWILLShopify app, Shopify will show the technical namespace with an app prefix.

The full metafield names are:

Metafield	Meaning	Example
`app--5843795--trustwill.loyalty_state`	Customer loyalty status	`member`, `guest`, `excluded`
`app--5843795--trustwill.points_balance`	Customer’s available points balance	`320`
`app--5843795--trustwill.tier_name`	Customer’s current tier name	`Gold`, `VIP`, `Silver`

app--181831499777--trustwill is the Shopify app-owned namespace for Trustwill. Merchants do not need to edit this namespace manually.

In Liquid, these fields can be accessed like this:

{% assign loyalty_state = customer.metafields["app--5843795--trustwill"].loyalty_state.value | downcase %}
{% assign points_balance = customer.metafields["app--5843795--trustwill"].points_balance.value | default: 0 | plus: 0 %}
{% assign tier_name = customer.metafields["app--5843795--trustwill"].tier_name.value %}

Example:

{% if customer and loyalty_state == 'member' %}
  <p>You have {{ points_balance }} points.</p>
{% else %}
  <p>Join rewards to earn points and unlock member benefits.</p>
{% endif %}

How to Enable

Go to TrustWILL Loyalty Admin.
Open Preference.
Go to Shopify Sync.
Find Sync loyalty data to Shopify metafield.
Turn on the sync.
TrustWILL will create or update the customer metafields in Shopify.
After sync, loyalty data will be updated automatically when a customer’s loyalty status, points balance, or tier changes.

Metafield Access and Permissions

TrustWILL loyalty metafields are read-only from the merchant’s perspective.

This means merchants can view and use these metafields in Shopify, but the values should be managed by TrustWILL. When a customer’s loyalty status, points balance, or tier changes, TrustWILL will automatically update the corresponding Shopify customer metafields.

To make the data easier to use across Shopify, TrustWILL enables the following access by default:

Storefront access
Analytics access
Third-party app access, where supported by Shopify permissions

This allows loyalty metafields to be used in storefront Liquid, customer segmentation, analytics, Shopify Flow, and supported third-party apps.

Common Use Cases

Once loyalty data is synced to Shopify metafields, merchants can use it across Shopify for member pricing, storefront personalization, segmentation, and customer analysis.