Skip to main content

Klaviyo Profile Properties

The delivery and CashBack fields Onward writes onto each profile, and how to segment on them.

Beyond pushing tracking events, Onward also syncs useful data directly to your Klaviyo customer profiles. This gives you powerful segmentation and targeting capabilities based on real delivery history.


What Gets Synced

Onward updates the following custom properties on each customer's Klaviyo profile.

Delivery Stats

Property

Description

Example

onward_total_orders_delivered

Total number of orders successfully delivered to this customer from your store.

5

onward_last_order_delivered_at

The date and time of the customer's most recent delivery (ISO 8601 format).

"2025-01-10T14:30:00Z"

These properties are updated whenever a shipment is delivered (or picked up by the customer).

CashBack (If Applicable)

If your store uses CashBack, Onward syncs the customer's full reward state to their Klaviyo profile — ten properties in all. Remember that CashBack is a personalized discount code, so onward_discount_code is the value a customer actually redeems.

Property

Description

onward_balance

CashBack the customer can spend right now.

onward_pending_issuance_balance

CashBack earned but not yet issued to the customer.

onward_discount_code

The customer's personalized CashBack discount code — use this in your emails.

onward_rewards_currency

Currency the balance is denominated in.

onward_lifetime_issued

Total CashBack ever issued to this customer.

onward_lifetime_used

Total CashBack the customer has redeemed.

onward_lifetime_refunded

Total CashBack refunded back to the customer.

onward_platform_discount_id

The matching Shopify discount identifier, for reconciliation.

onward_customer_id

Onward's identifier for this customer.

onward_shop_id

Onward's identifier for your store.


When Properties Are Updated

  • Delivery stats are synced each time a shipment for the customer reaches "delivered" or "picked up" status.

  • CashBack properties are synced when the balance changes (for example, a reward is issued or redeemed).

Updates happen automatically — no manual action required.


How to Use Profile Properties in Klaviyo

Segmentation

Create segments based on delivery history:

  • Repeat buyers with deliveries — Customers where onward_total_orders_delivered is greater than 3. Great for loyalty campaigns.

  • Recently received an order — Customers where onward_last_order_delivered_at is within the last 7 days. Perfect timing for a review request or cross-sell.

  • First delivery — Customers where onward_total_orders_delivered equals 1. Welcome them with a special post-delivery message.

  • Unspent CashBack — Customers where onward_balance is greater than 0. Remind them what they have waiting, and include onward_discount_code so they can redeem it in one click.

Personalization in Flows

Use profile properties in your Klaviyo email and SMS templates:

  • "This is your {{ person.onward_total_orders_delivered }}th order with us — thank you for being a loyal customer!"

  • "You have {{ person.onward_balance }} in CashBack waiting. Use code {{ person.onward_discount_code }} at checkout."

  • Conditional content: Show different messaging for first-time vs. repeat customers.

Conditional Flow Splits

Use profile properties as conditions in your Klaviyo flows:

  • After a "Delivered" event, check if onward_total_orders_delivered is greater than 1. If yes, send a loyalty reward. If no, send a first-delivery welcome.

  • After delivery, check if onward_last_order_delivered_at was within the last 30 days. If the customer has received multiple deliveries recently, they may be a high-value customer worth targeting with an exclusive offer.


Viewing Properties in Klaviyo

To see Onward properties on a customer profile:

  1. Go to your Klaviyo account.

  2. Navigate to Profiles and search for a customer.

  3. Open the customer's profile.

  4. Look in the Custom Properties section for properties prefixed with onward_.

Did this answer your question?