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

Turn On Custom Fields

In JeriCommerce, go to Settings → Integrations → Shopify, turn on Custom Fields, and save. The initial bulk sync fills available values for eligible existing customer profiles.

When a customer is imported or an existing JeriCommerce profile is linked to a Shopify customer, JeriCommerce saves the profile data first, then queues a separate background job to sync the fields currently available for that customer. The fields may appear after that job runs.

The initial import runs through background stages in this order: Users, Loyalty, then Custom Fields. If Shopify omits a profile field, JeriCommerce leaves its existing value unchanged.

How Sync Works on Shopify

  • Real-time: Each metafield updates via a Shopify GraphQL customerUpdate mutation when the data changes (2-second debounce).
  • Initial 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. Only values available for each eligible customer are included.

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.