Klaviyo Reviews data reference

Klaviyo Reviews data reference

Estimated 7 minute read

Updated Sep 29, 2025, 12:00 AM EST

Table of contents

You will learn
How to view your data
Delivery metrics
Reviews metrics
Profile data
Additional resources

You will learn

Learn about the additional data available in Klaviyo when you start using reviews. This data falls into 2 broad categories: delivery metrics (Shopify only) and reviews metrics (available for WooCommerce and Shopify).

How to view your data

Klaviyo Reviews syncs several metrics to your Klaviyo account. To view these metrics:

Click the Analytics dropdown in the left navigation of Klaviyo.
Select Metrics.

From the Integration filter, choose Klaviyo.
Klaviyo Reviews metrics are displayed among other Klaviyo metrics. Search for a specific metric, or read below to identify the metrics available through Klaviyo Reviews.

Delivery metrics

Delivery-related metrics include Package in transit, Package delivered, and more. Use these metrics to build flows and segments based on the status of a customer’s order.

Delivery-related metrics are only available for those who use Shopify. If you use WooCommerce as your ecommerce platform, these metrics are not available.

Package delivered

This event is tracked when a customer’s package is delivered. Use this metric to trigger a flow message to let your customer know their order has arrived.

Package in transit

This event is tracked when a carrier accepts a package you’ve shipped to a customer. Unlike Fulfilled Order events, which are generally tracked when you create a shipping label for an order, this event isn’t tracked until the carrier scans the package into their system and indicates it is in transit.

Use this event to trigger your shipment confirmation flow so that your customers can view carrier tracking information for their order right away.

Package out for delivery

This event is tracked when a carrier indicates a package is set to be delivered that day. Use this event to trigger a message letting your customer know to be on the lookout for their order today.

Delivery metrics properties

All delivery metrics include the following properties:

product(Legacy, Shopify only) Contains an array of details about the reviewed product, including its title, URL, and images.
store_urlYour store’s website URL.
structured_product Contains an array of details about the reviewed product, including its title, URL, and images.
review_linkThe custom link your customer will use to submit their review.
shopify_order_number The order number in your Shopify admin.
order_number The order number from your ecommerce platform.
package_tracking_number The tracking number used to locate the package.
package_statusThis may be unknown, out_for_delivery, or delivered.
est_delivery_dateThe estimated date when the order will be delivered.
shipping_destination The country code (e.g., US) where the package was shipped.
shipping_carrier The package carrier (e.g., USPS, FedEx).
extra Additional details about the order from your ecommerce platform, including items shipped, shipping address, and more.

Reviews metrics

Ready to review

This metric is tracked when an item is delivered or fulfilled and meets the criteria you set to indicate an item is ready to be reviewed. Learn how to customize the Ready to review metric.

This metric triggers the Request review - Klaviyo Reviews flow found in the flow library.

Ready to review events are only triggered for orders placed after you begin using Klaviyo Reviews. Learn how to populate the Ready to review metric for past orders.

This metric’s top-level properties include:

product(Legacy, Shopify only) Contains details about the reviewed product, including its title, URL, and images.
store_urlYour store’s website URL.
structured_product Contains details about the reviewed product, including its title, URL, and images.
review_linkThe custom link your customer can use to submit their review.
shopify_order_number The order number in your Shopify admin.
package_tracking_number The tracking number used to locate the package.
package_status The shipment status, such as delivered, fulfilled, or unknown. A Ready to review event does not confirm that the order was delivered.
est_delivery_dateThe estimated delivery date, or unknown when a date is unavailable.
shipping_destination The country code (e.g., US) where the package was shipped.
shipping_carrier The package carrier (e.g., USPS, FedEx).
extra Additional details about the order from your ecommerce platform, including items shipped, shipping address, and more.
$event_id The unique ID for the Ready to review event.

Submitted review

This metric is tracked when a customer submits a review. It serves as the trigger for the Review reward - Klaviyo Reviews flow in the flow library.

This metric’s top-level properties include:

product(Legacy, Shopify only) Contains details about the reviewed product, including its title, URL, and images.
store_url Your store’s website URL.
structured_product Contains details about the reviewed product, including its title, URL, and images.
review_linkThe custom link your customer used to submit their review.
review_ratingA number 1-5 indicating the customer’s rating.
review_images An array of image URLs, if the reviewer submitted product images.
review_authorThe handle of the person who submitted the review.
review_emailThe email address of the person who submitted the review.
review_contentThe body text of the review submitted by the customer.
review_titleThe title of the review submitted by the customer.
review_statusWhether the review is published or pending when it is initially submitted. This field does not update if a review’s status changes (i.e., moves from pending to rejected).
review_verified True or false, indicating whether the review is from a verified purchaser. Reviews are marked as verified if they are submitted through a review request flow message sent via Klaviyo or if a user checks the I confirm that the imported reviews are genuine option when uploading reviews.
review_has_mediaTrue or false, indicating whether an image or video was included in the review.
$event_idThe unique ID for the review event.

Klaviyo only collects variant information when a review is submitted in response to a review request. Reviews submitted by navigating to a product page and manually clicking the Write a review button will not include variant information.

Submitted rating

This metric is tracked when a customer submits a rating (i.e., a star rating for a product without additional content like a text review). The customer can still add a written review afterward.

product(Legacy, Shopify only) Contains details about the reviewed product, including its title, URL, and images.
store_url Your store’s website URL.
structured_product Contains details about the reviewed product, including its title, URL, and images.
review_linkThe custom link your customer used to submit their review.
review_ratingA number 1-5 indicating the customer’s rating.
shopify_order_number (Shopify only) The order number from Shopify.
order_number The order number from your ecommerce platform.
package_tracking_number The tracking number for the item the customer reviewed.
package_status The package status; generally delivered for all rated products.
shipping_destination The city and state where the package was shipped.
shipping_carrierThe carrier for the reviewed item's package (e.g., USPS, FedEx).
est_delivery_date The product's delivery date (generally a date in the past).
extraAdditional details about the order from your ecommerce platform, including items shipped, shipping address, and more.
$event_idThe unique ID for the review event.

Analyzed review topic sentiment

Sentiment analysis must be enabled in Reviews > Performance. Only verified reviews submitted through review requests can be analyzed.

This metric is tracked when Klaviyo uses AI to analyze a review’s content. Use this metric to filter flows by topic or sentiment. For an example based on star ratings, learn how to create support tickets automatically.

product(Legacy, Shopify only) Contains an array of details about the reviewed product, including its title, URL, and images.
$serviceAlways “klaviyo.”
store_urlYour store’s website URL.
review_linkThe custom link your customer used to submit their review.
order_numberThe order number from your ecommerce platform.
package_tracking_numberThe tracking number for the item the customer reviewed.
package_statusThe package status; generally delivered for all rated products.
shipping_destinationThe city and state where the package was shipped.
shipping_carrierThe carrier for the reviewed item's package (e.g., USPS, FedEx).
est_delivery_dateThe product's delivery date (generally a date in the past).
extraAdditional details about the order from your ecommerce platform, including items shipped, shipping address, and more.
review_idThe ID used in Klaviyo for the review.
review_ratingA number 1-5 indicating the customer’s rating.
review_authorThe handle of the person who submitted the review.
review_emailThe email address of the person who submitted the review.
review_contentThe body text of the review submitted by the customer.
review_titleThe title of the review submitted by the customer.
review_statusWhether the review is published or pending when it is initially submitted. This field does not update if a review’s status changes (i.e., moves from pending to rejected).
review_verifiedTrue or false, indicating whether the review is from a verified purchaser. Reviews are marked as verified if they are submitted through a review request flow message sent via Klaviyo or if a user checks the I confirm that the imported reviews are genuine option when uploading reviews.
review_has_mediaTrue or false, indicating whether an image was included in the review.
review_imagesAn array of image URLs, if the reviewer submitted product images.
product_external_idThe ID of the reviewed product from your product catalog.
structured_product Contains an array of details about the reviewed product, including its title, URL, and images.
topicThe topic of the review, as identified by Klaviyo AI (e.g., “productQuality”).
topic_nameThe friendly name of the topic of the review, as identified by Klaviyo AI (e.g., “Product Quality”).
sentimentThe sentiment expressed about the identified topic (i.e., “positive” or “negative”).
snippetA portion or summary of the review used by Klaviyo AI to identify its topic and sentiment.
subtopicAdditional information about the review’s topic, as identified by Klaviyo AI.
confidenceThe level of confidence Klaviyo AI has in the identified topic (e.g., “medium” or “high”).
klaviyo_tokenYour Klaviyo public API key.

Profile data

If you set up profile questions in your custom review questions, reviewers’ answers are saved to the custom profile property selected under Profile property name. Product questions collect feedback about the product and do not have this profile-property setting. Learn more about how to use profile properties.

Additional resources

Getting started with Klaviyo Reviews

Learn how to set up reviews so you can collect customer feedback and share positive reviews with your prospects. - How to export Klaviyo Reviews data

Learn how to export the reviews you collect in Klaviyo Reviews to a CSV. Once you’ve exported the data, you can analyze it using a spreadsheet tool like Google Sheets or import it into a new platform. - Shopify data reference

Learn what data syncs from Shopify to Klaviyo and where to view it. This includes both order data (such as Placed Order, Ordered Product, etc.), delivery data, onsite tracking data, and customer data. If you have not already, read our guide on getting started with Shopify for step-by-step instructions on integrating, before continuing with this article.

Was this article helpful?

YesNo

Use this form only for article feedback. Learn how to contact support.