Shopify metafield sync is available for Shopify merchants on our Classic plan and above.
What are metafields?
LoyaltyLion will push customer properties to Shopify customer metafields when a customer changes: When a customer earns points, or their tier changes, we can update a metafield on the corresponding customer resource in Shopify.
Metafields can be accessed in Liquid templates as well as from the API, which enables some powerful integrations and custom interfaces.
LoyaltyLion fields
The following fields can be pushed as customer metafields. You can enable or disable the exact metafields we'll push from the Integrations section of the LoyaltyLion admin.
Description - Example - Metafield name
Total points - 1000 - loyaltylion.points_total
Approved points - 800 - loyaltylion.points_approved
Pending points - 200 - loyaltylion.points_pending
Lifetime points - 2000 - loyaltylion.points_lifetime
Spent points - 1000 - loyaltylion.points_spent
Number of rewards claimed - 3 - loyaltylion.rewards_claimed
Date enrolled in program (YYYY-MM-DD) - 2017-09-20 - loyaltylion.enroll_date
Referral URL - http://prz.io/KzByQ2Fa - loyaltylion.referral_url
Loyalty Tier - Silver - loyaltylion.loyalty_tier
Loyalty Tier (customer tag) - tag: Silver
Birthday (YYYY-MM-DD) - 1970-03-15 - loyaltylion.birthday
Steps for filling in the metafields
You will need to fill in the metafields to show the customer's LL data in Shopify.
❗ You may also see an unstructured metafield called "loyaltylion.seamless-product-discounts" or "loyaltylion.crr-voucher-id" - do NOT add a definition for these metafields, as this may cause issues with LoyaltyLion discounts
Go to Settings in Shopify -> Custom data -> Customers and select View unstructured metafields
After clicking Add definition for one of the LoyaltyLion fields :
Add a Name
Click Select Type, and select the correct type for the field as per the screenshot below
Do not add any Validations
Make sure the Storefronts access under Options is set to Read
The metafield should then look like the below screenshot
Save the metafield
Continue steps a through f for the remaining LoyaltyLion unstructured metafields
Make sure to set the definitions types as per screenshot. Otherwise, the integration won't work as expected.
Do not put validations when creating metafields.
3. After saving, the metafield appeared in Definitions with the added “customer.metafields”.
Using metafields
Within Liquid templates
You can reference metafields in most Liquid templates like so:
{{ customer.metafields.loyaltylion.points_total }}For example, to display the customer's unique referral link:
referral url: #{{ customer.metafields.loyaltylion.points_total }}
Things to be aware of: sync timing.
Although we generally sync metafields straight away, usually within a few minutes of a customer changing in LoyaltyLion, the sync can be delayed, particularly if many customers change at once, due to Shopify API rate limit restrictions.
If you're using metafields in an integration or in a template, you should account for their values being slightly out of date, or, in the case of new customers, blank.
If a customer has reported that their values look out of date, you can perform a singular sync for that specific customer, by going to their customer profile in your LoyaltyLion program, clicking on the actions button, and selecting 'Sync Metafields'
References
FAQ
Q. What's the difference between Loyalty Tier and Loyalty Tier (customer tag)?
Loyalty Tier syncs a metafield, which can be referenced in your Shopify theme.
Loyalty Tier (customer tag) adds a tag, which appears in the customer profile.
