When the Custom Fields feature is enabled on 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.
Go to Settings > Integrations, select your platform (Shopify or Klaviyo), and toggle on the Custom Fields feature. Then save.
Once enabled, a bulk sync runs automatically to populate all existing customer profiles. After that, each property updates in real time as the underlying data changes.
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 full sync (when Custom Fields is enabled) |
| 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 |
| Method | When | Details |
|---|---|---|
| Real-time | On every data change | Each property updates individually with a 2-second debounce |
| Bulk sync | When Custom Fields is first enabled | All existing customers are synced at once to populate their profiles |
Each platform has its own field naming, data types, and sync method. See the detailed guides below for the exact mapping on each integration:
Sync Custom Fields with Shopify — Metafield keys, Shopify types, where they appear, and customer tags.
Sync Custom Fields with Klaviyo — Profile property names, data formats, and key differences vs Shopify.