When Custom Fields is enabled on 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 Naming

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

Klaviyo Property NameTypebalanceinteger (as string)birthdatedate (yyyy-MM-dd)jericommerce_download_wallet_pass_urlURL stringtier-namestringtier-balanceinteger (as string)tier-entered-atdate (yyyy-MM-dd)tier-expires-atdate (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 on Klaviyo

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

Related: Register Wallet Events on Klaviyo — Send JeriCommerce events to Klaviyo for flow triggers and analytics.