When the Custom Fields feature is turned on for an integration, JeriCommerce automatically synchronizes key customer data with your connected platforms. This keeps your customer profiles up to date across tools, enabling personalized marketing, segmentation, and automation.
Custom Fields is a one-way sync — data flows from JeriCommerce to your connected platforms (Shopify, Klaviyo), not the other way around. Changes made directly in Shopify or Klaviyo will not sync back to JeriCommerce and may be overwritten on the next sync.
How to Turn On Custom Fields ¶
Go to Settings > Integrations, choose your platform (Shopify or Klaviyo), and toggle on the Custom Fields feature. Then save.
Once turned on, an initial bulk sync populates eligible existing customer profiles. JeriCommerce also syncs currently available fields after a customer is imported or linked to a Shopify profile. After the initial sync, fields update when the underlying data changes.
Synchronized Properties ¶
The following customer properties are synced to every platform that has Custom Fields enabled. The property names may vary slightly depending on the platform — see the platform-specific guides for exact field mappings.
| Property | Description | When It Syncs |
|---|---|---|
balance |
Customer's current loyalty points balance | Every time the balance changes |
birthdate |
Customer's birthdate | When the customer is first created |
download-wallet-pass-url |
Personalized one-time URL to download the wallet pass | During the initial sync when a link is available, and when the link changes |
tier-name |
Name of the customer's current tier (e.g. "Gold") | When the tier is created or changes |
tier-balance |
Current tier qualifying points | When the tier is created or changes |
tier-entered-at |
Date the customer entered their current tier | When the tier is created or changes |
tier-expires-at |
Date when the tier will be recalculated | When the tier is created or changes |
Sync Timing ¶
| Method | When | Details |
|---|---|---|
| Real-time | On every data change | Each property updates individually with a 2-second debounce |
| Initial sync | When Custom Fields is turned on | Eligible existing customers are synced in a background bulk job |
| Import or profile linking | When an imported customer is linked to a Shopify profile | Currently available fields are synced to the linked profile |
Platform-Specific Guides ¶
Each platform has its own field naming, data types, and sync method. See the detailed guides below for the exact mapping on each integration: