When Custom Fields is turned on in your Klaviyo integration, JeriCommerce syncs customer attributes as profile custom properties via the Klaviyo Profile Import API. These properties appear in Klaviyo > Profiles > [Profile] > Custom Properties, and can be used in flows, segments, and dynamic content.

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

Klaviyo property names

Most property names match the generic ones, but there are key differences in naming and data types specific to Klaviyo:

Klaviyo Property Name Type
balance Integer (as string)
birthdate Date (yyyy-MM-dd)
jericommerce_download_wallet_pass_url URL string
tier-name String
tier-balance Integer (as string)
tier-entered-at Date (yyyy-MM-dd)
tier-expires-at Date (yyyy-MM-dd)

Key differences vs Shopify

  • Profile identification: Customers are matched by email in Klaviyo (vs. Shopify's GraphQL customer ID).
  • Property naming: The download URL maps to jericommerce_download_wallet_pass_url (underscores instead of hyphens).
  • Date formatting: Dates are sent as yyyy-MM-dd strings. If a date is missing, the value "-" is sent.

How sync works

  • Real-time: Each property updates via Klaviyo's Profile Import API when the data changes (2-second debounce).
  • Bulk sync: When Custom Fields is first turned on, a bulk import runs using Klaviyo's Profile Bulk Import Jobs API, processing 500 customers per batch.

Check Register Wallet Events on Klaviyo to also send JeriCommerce events to Klaviyo for flow triggers and analytics.