When Custom Fields is enabled on your Shopify integration, JeriCommerce creates and maintains customer metafields under the jericommerce namespace.

These appear in Shopify Admin > Customers > [Customer] > Metafields, and are available in Shopify Liquid, Shopify Flow, and the Shopify API.

For the full list of synchronized properties, what they represent, and when each one syncs, see Custom Fields: Synchronized Customer Properties.

Shopify Metafield Keys

All metafields live under the jericommerce namespace. The following keys are created for each customer:

Metafield Key
jericommerce.balance
jericommerce.birthdate
jericommerce.download-wallet-pass-url
jericommerce.tier-name
jericommerce.tier-balance
jericommerce.tier-entered-at
jericommerce.tier-expires-at

How Sync Works on Shopify

  • Real-time: Each metafield updates via a Shopify GraphQL customerUpdate mutation when the data changes (2-second debounce).
  • Bulk sync: When Custom Fields is first enabled, a bulk operation generates a JSONL file and uploads it via Shopify's Staged Uploads + Bulk Mutation API, populating all existing customers at once.

Customer Tags

In addition to metafields, JeriCommerce manages two customer tags to track wallet pass installation status. Only one tag is present at any time.

Tag When It's Set
JericommercePassInstalled When the customer saves the wallet pass to Apple Wallet or Google Wallet
JericommercePassUninstalled When the customer removes the wallet pass from Apple Wallet

These tags appear in the Shopify Admin under the customer's tag list and can be used in Shopify segments, flows, and automations.

Related: Shopify Flows and Events — Learn how to use JeriCommerce events as triggers in Shopify Flow.