Rivo supports two customer metafield formats in Shopify:
Customer Metafields (Recommended) - The current V2 format with individual customer fields.
Legacy Customer JSON Metafield (Deprecated) - The older single JSON object kept for backward compatibility.
What syncs in the recommended V2 format
When Customer Metafields is enabled, Rivo syncs individual customer fields.
Core fields
account_activated_atfirst_redeemed_at
If your Points program is enabled
points_balancecredits_balanceloyalty_status
If Wallet Pass is enabled
is_wallet_pass_subscriber
If Membership is enabled
membership_tiermembership_first_joined_datemembership_next_billing_date
Customer preferences
If you use customer preference questions, each active preference response can also sync as its own customer metafield.
What does not sync
Rivo does not sync a customer’s full points transaction history to Shopify metafields.
Individual earn and redeem entries are not written as separate metafields.
Only current customer-level values (such as balances and status) are synced.
Enable customer metafields (V2)
In Rivo, go to Settings -> Shopify Metafields & Tags.
In Shopify Metafields, enable Customer Metafields (Recommended).
Save your settings.
Optional: In Troubleshooting, use Sync Store to run a full resync for existing customers.
Legacy Customer JSON metafield (deprecated)
Enable Legacy Customer JSON Metafield only if you still rely on older theme or email implementations that use the legacy JSON payload.
The legacy JSON payload includes:
points_balancecredits_balancestatusvip_tierdobdob_last_updated_atreferral_code
This option is deprecated and not recommended for new setups.
FAQ
Do points entries sync to Shopify metafields?
No. Individual points events and redemptions do not sync as separate metafields.
Do I need Shopify Plus?
No. Availability depends on your Rivo plan features. If you do not see Shopify Metafields settings, contact support to confirm access for your plan.
How quickly do updates appear?
Metafields are updated after relevant profile and points or preference updates are processed. Timing can vary. If you need a full refresh, use Sync Store.