Using Yotpo Loyalty & Referrals Metafields in Shopify
- DarkLight
Using Yotpo Loyalty & Referrals Metafields in Shopify
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Goals and Outcomes
Shopify metafields allow you to store and display custom data across your store, including on customers, products, and orders. With Yotpo Loyalty & Referrals, essential loyalty program data is automatically synced to customer metafields in Shopify. This gives you greater visibility and control over your loyalty data while enabling more personalized shopping experiences and smarter automation.
In this article, you’ll learn:
What Yotpo loyalty data is available as metafields in Shopify
How to access and manage these metafields in the Shopify admin
Examples of using loyalty metafields to support your business strategy
Yotpo Loyalty Data as Metafields
Yotpo loyalty metafields are available to all merchants on Pro, Premium, and Enterprise plans with an active loyalty program. These metafields are automatically added to customer profiles and synced in real-time between Yotpo and Shopify.
Note
If you want to stop metafield syncing, please contact your Yotpo representative or our support team.
Compatibility
Supports both Shopify's Legacy and new Customer Accounts.
Works with Yotpo’s multi-store feature.
Yotpo Loyalty Metafields
The following core loyalty data is saved and available as customer metafields in Shopify:
Shopify account
Loyalty opt-in
Loyalty opt-in date
Loyalty points balance
Learn more in the table below:
Metafield name | Namespace and key | Description | Value type | Behavior by Shopify account type |
|---|---|---|---|---|
Yotpo Loyalty Has Shopify Account |
| Indicates whether the customer has a Shopify account. | Boolean
| Legacy accounts: Shows True if the customer has a Shopify account, and False if they don’t. Customer Accounts: The value is False by default since there is no account creation. |
Yotpo Loyalty Opt-in |
| Indicates if the customer is opted into your loyalty program. | Boolean
| Based on your program’s opt-in strategy: “All customers” - customers are automatically enrolled, so "True" will appear after a customer record is created in Shopify, for both new Customer Accounts and Legacy accounts. “Only members who signed up” - it depends your Shopify account type:
|
Yotpo Opt-in Date |
| Timestamp of when the customer opted into the loyalty program. | ISO 8601 DateTime Displays N/A if the customer is not opted in. | |
Yotpo Loyalty Points Balance |
| The customer’s current points balance. | Integer Example: 0, 100, -100 |
Important
Yotpo loyalty metafields are read-only, flat, and cannot be manually edited in Shopify to prevent data inconsistencies and ensure your loyalty data is correct.
All metafields follow a unified format using a namespace and key to ensure uniqueness, e.g., app--123456789--loyalty_opt_in.
Viewing Metafields in the Shopify Admin
.gif)
To view Yotpo loyalty metafields in your Shopify admin:
From your Shopify Admin, go to Settings.
Select Metafields and metaobjects and click the Customers definition.
From the actions dropdown, select View read only definitions.
You’ll see Yotpo loyalty metafields listed with their respective names and values.
To view data for a specific customer, go to Customers, select a customer, and scroll down to the Metafields section.
Use Cases and Examples
1. Create Flows with Shopify Flow
Use Yotpo loyalty metafields to create Shopify Flows and trigger automations.
Example: Send a post-purchase marketing email to loyalty members (using the yotpo.loyalty_opt_in metafield) after they place an order.
2. Personalize Product Pages with Loyalty Data
Boost product page conversion by showcasing social proof from your loyalty program.
Example: Display the number of loyalty members who bought a product directly on the product page (e.g., “15 loyalty members bought this in the last 30 days”) to encourage purchases through FOMO and trust.
Over 65% of customers prefer buying from brands they feel loyal to. Showcasing loyalty insights helps strengthen that connection and boost repeat purchases.
3. Show Dynamic Messaging or Pricing Based on Loyalty Status
Customize your storefront experience and build exclusivity based on loyalty membership.
Example: Show members-only pricing or promos based on loyalty status (yotpo.loyalty_opt_in = true), along with a message like “Welcome back! As a member, you save 15% on this item.”
Was this article helpful?
