Skio event and profile properties in Klaviyo

Prev Next

What are event and profile properties?

Skio automatically sends subscription events and customer data to Klaviyo via event metrics, giving you the properties you need to build targeted flows and segments. This guide shows you which properties are available and how to use them in common subscription flows.

How Skio sends data to Klaviyo

Example: When a new subscription is created, Skio sends a subscriptionCreated event metric that includes three types of properties: event properties (like nextBillingDate), profile properties (customer information), and custom properties.

Skio sends three types of data to Klaviyo with each event:

  • Event properties: Sent each time a subscription event occurs (like a renewal, cancellation, or product swap). These are tied to specific moments in the subscription lifecycle.

  • Profile properties: Updated on the customer's Klaviyo profile and persist across all events. These reflect the customer's current subscription state.

  • Custom properties: These properties may change depending on what type of event is being sent.

Learn more about how to add personalization to your flows in Klaviyo here.

Common Klaviyo flows and the properties you need

Renewal reminder flows

Send reminders before a subscription renews to reduce surprises and payment failures.

Property

Type

Description

Example use

nextBillingDate

Event

When the subscription will renew

Trigger flow 3 days before this date

skioSubscriptionDaysUntilRenewal

Event

Days until next renewal

"Your order ships in {{ event.skioSubscriptionDaysUntilRenewal }} days"

netSubscriptionTotal

Event

Total order value before shipping

"Your upcoming charge: ${{ event.netSubscriptionTotal }}"

deliveryPrice

Event

Shipping cost

Show total including shipping

productName

Event

Product in the order

Remind them what's coming

manageSubscriptionUrl

Event

Direct link to Customer Portal. Alternatively, use a Quick Action link.

"Update your order: {{ event.manageSubscriptionUrl }}"

Flow structure example:

  • Trigger: Skio renewal event

  • Time delay: Wait until 3 days before nextBillingDate

  • Email: "Your [product] ships in 3 days"

Winback flows (post-cancellation)

Re-engage customers who cancelled their subscription.

Property

Type

Description

Example use

cancelledAt

Event

Timestamp of cancellation

Trigger flow immediately or with delay

cyclesCompleted

Event

Number of orders before cancelling

Segment by loyalty: "Thanks for 6 orders with us"

productName

Event

What they were subscribed to

Personalize: "Missing your [product]?"

skio_hasCancelledSubscription

Profile

Whether customer has any cancelled subs

Use in segments to exclude active subscribers

skio_cancelledSubscriptionCount

Profile

Total cancelled subscriptions

Identify high-risk customers

Flow structure example:

  • Trigger: Skio cancellation event

  • Time delay: Wait 7 days

  • Conditional split: If skio_hasActiveSubscription = false (they have no other active subs)

  • Email: Winback offer with incentive

Payment failure recovery flows

Recover revenue when a subscription payment fails.

Property

Type

Description

Example use

status

Event

Subscription Status

Trigger when status = "FAILED" or "PAST_DUE"

skio_hasFailedSubscription

Profile

Whether customer has failed subs

Segment for follow-up campaigns

skio_failedSubscriptionCount

Profile

Number of failed subscriptions

Prioritize high-value recovery

manageSubscriptionUrl

Event

Direct link to update payment

"Update your payment method: [link]"

skio_hasBackupPaymentMethod

Profile

Whether backup payment exists

Split messaging based on payment status

email

Event/Profile

Customer email

Coordinate with email dunning

Flow structure example:

  • Trigger: Skio payment failed event

  • Email 1: Friendly reminder to update payment

  • Wait 3 days

  • Email 2: IMPORTANT - update your payment method

All event properties sent to Klaviyo

Event properties

These variables can be used as Trigger filters and splits in addition to being used to display dynamic information about the event in a message.

Property

Brief description

subscriptionId

Unique identifier for the subscription associated with the event

subscriptionLinePlatformId

Platform-level ID of the subscription line related to the event

status

Subscription status at the time the event occurred

statusContext

Additional context explaining the subscription status

nextBillingDate

Next scheduled billing date at the time of the event

subscriptionWillRenewAtTimezoneAdjusted

Timezone-adjusted renewal timestamp

skioSubscriptionDaysUntilRenewal

Number of days until the next renewal when the event fired

interval

Billing interval unit (e.g., week, month)

intervalCount

Number of intervals between billings

cyclesCompleted

Number of billing cycles completed at event time

price

Price of the product involved in the event

quantity

Quantity of the product involved in the event

total

Total amount associated with the event

netSubscriptionTotal

Net subscription total after discounts

netSubscriptionTotalSiteCurrency

Net subscription total in the site’s currency

deliveryPrice

Shipping price applied at the time of the event

totalDiscount

Total discount amount applied at event time

discounts

Standard discounts applied during the event

surpriseDiscounts

Surprise discounts applied during the event

hasSurpriseDiscount

Indicates whether a surprise discount was applied

currencyCode

Currency code used for pricing (e.g., USD, CAD)

currencySymbol

Currency symbol used for display

siteCurrencyCode

Store’s base currency code

productName

Name of the product involved in the event

productVariantName

Name of the product variant involved

productVariantSku

SKU of the product variant

productPlatformId

Platform-level product ID

productVariantPlatformId

Platform-level product variant ID

productImage

Product image URL

productVariantImage

Product variant image URL

isOneTimeUpsell

Indicates whether the product was a one-time upsell

isPrepaid

Indicates whether the subscription is prepaid

isPrepaidGift

Indicates whether the prepaid subscription is a gift

isTemporarilyPaused

Indicates whether the subscription was temporarily paused

skipped

Indicates whether the item was skipped

outOfStock

Indicates whether the item was out of stock

originOrderId

Original order ID associated with the subscription

manageSubscriptionUrl

URL used by customers to manage their subscription

qaToken

Secure token used for authenticated actions related to the event

storefrontUserId

Storefront user ID associated with the event

customerPlatformId

Platform-level customer ID associated with the event

email

Customer email address associated with the event

Profile properties

Property

Brief description

firstName

Customer’s first name

lastName

Customer’s last name

email

Customer email address

phone

Customer phone number

address1

Primary street address

address2

Secondary street address

city

City

province

State or region

zip

Postal or ZIP code

country

Country

locale

Customer locale or language setting

recipientTimeZone

Customer’s time zone

latitude

Geographic latitude, if available

longitude

Geographic longitude, if available

uniqueId

Unique identifier for the customer profile

Custom properties

These variables can be used as Conditional filters and splits in addition to being used to display dynamic information about the event in a message.

Property

Brief description

skio_storefrontUserId

Storefront user ID tracked by Skio

skio_hasActiveSubscription

Indicates whether the customer has an active subscription

skio_activeSubscriptionCount

Total number of active subscriptions

skio_hasPrepaidSubscription

Indicates whether the customer has prepaid subscriptions

skio_prepaidSubscriptionCount

Total number of prepaid subscriptions

skio_hasPausedSubscription

Indicates whether the customer has paused subscriptions

skio_pausedSubscriptionCount

Total number of paused subscriptions

skio_pausedSubscriptions

List of paused subscriptions

skio_hasFailedSubscription

Indicates whether the customer has failed subscriptions

skio_failedSubscriptionCount

Total number of failed subscriptions

skio_failedSubscriptions

List of failed subscriptions

skio_hasCancelledSubscription

Indicates whether the customer has cancelled subscriptions

skio_cancelledSubscriptionCount

Total number of cancelled subscriptions

skio_cancelledSubscriptions

List of cancelled subscriptions

skio_totalItemQuantity

Total quantity of items across all subscriptions

skio_nextBillingDate

Next billing date across subscriptions

skio_cyclesCompleted

Total number of completed billing cycles

skio_nextBillingActiveSubscriptionId

ID of the active subscription that will bill next

skio_hasBackupPaymentMethod

Indicates whether a backup payment method exists

skio_qaToken

Secure token for authenticated subscription actions

skio_credits

Available Skio credits balance

skio_credits_currency_value

Monetary value of Skio credits

skio_credits_currency_code

Currency code used for Skio credits

Conditional filters & splits

Property

Brief description

skio_activeSubscriptions_conditionSplit

Active subscriptions used for conditional logic and splits

skio_pausedSubscriptions_conditionSplit

Paused subscriptions used for conditional logic and splits

skio_failedSubscriptions_conditionSplit

Failed subscriptions used for conditional logic and splits

skio_cancelledSubscriptions_conditionSplit

Cancelled subscriptions used for conditional logic and splits

skio_subscribedProductTitles_conditionSplit

Subscribed product titles used for segmentation

skio_subscribedVariantTitles_conditionSplit

Subscribed variant titles used for segmentation

skio_subscribedSKUs_conditionSplit

Subscribed SKUs used for segmentation

Additional resources