Klaviyo Reviews data reference

You will learn

Learn about the additional data available in Klaviyo when you start using reviews. This data falls into two 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: 

1. Click the Analytics dropdown in the left navigation of Klaviyo. 
2. Select Metrics.
   
3. From the All integrations dropdown, choose Klaviyo.
4. 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. 

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_url
  Your store’s website URL.
• structured_product
  Contains an array of details about the reviewed product, including its title, URL, and images.
• review_link
  The 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_status
  This may be unknown, out_for_delivery, or delivered.
• est_delivery_date
  The 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 (paid plans) or fulfilled (free plans) 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. 

This metric’s top-level properties include: 

• product
  (Legacy, Shopify only) Contains an array of details about the reviewed product, including its title, URL, and images.
• store_url
  Your store’s website URL.
• structured_product
  Contains an array of details about the reviewed product, including its title, URL, and images.
• review_link
  The 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
  This will always be delivered.
• est_delivery_date
  The date when the order was 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. 
• $event_id
  The unique ID for the Package out for delivery 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 an array of details about the reviewed product, including its title, URL, and images.
• store_url
  Your store’s website URL.
• structured_product
  Contains an array of details about the reviewed product, including its title, URL, and images.
• review_link
  The custom link your customer used to submit their review.
• review_rating
  A number 1-5 indicating the customer’s rating. 
• review_images
  An array of image URLs, if the reviewer submitted product images.
• review_author
  The handle of the person who submitted the review.
• review_email
  The email address of the person who submitted the review.
• review_content
  The body text of the review submitted by the customer. 
• review_title
  The title of the review submitted by the customer. 
• review_status
  Whether 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_media
  True or false, indicating whether an image was included in the review. 
• $event_id
  The unique ID for the review event. 

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).

• product
  (Legacy, Shopify only) Contains an array of details about the reviewed product, including its title, URL, and images.
• store_url
  Your store’s website URL.
• structured_product
  Contains an array of details about the reviewed product, including its title, URL, and images.
• review_link
  The custom link your customer used to submit their review.
• 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_carrier
  The 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).
• extra
  Additional details about the order from your ecommerce platform, including items shipped, shipping address, and more.
• $event_id
  The unique ID for the review event. 

Analyzed review topic sentiment

This metric is tracked when Klaviyo uses AI to analyze a review’s content. Use this metric to filter flows or create support tickets automatically. 

• product
  (Legacy, Shopify only) Contains an array of details about the reviewed product, including its title, URL, and images.
• $service
  Always “klaviyo.”
• store_url
  Your store’s website URL.
• review_link
  The custom link your customer used to submit their review.
• 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_carrier
  The 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).
• extra
  Additional details about the order from your ecommerce platform, including items shipped, shipping address, and more. 
• review_id
  The ID used in Klaviyo for the review. 
• review_rating
  A number 1-5 indicating the customer’s rating. 
• review_author
  The handle of the person who submitted the review.
• review_email
  The email address of the person who submitted the review.
• review_content
  The body text of the review submitted by the customer. 
• review_title
  The title of the review submitted by the customer. 
• review_status
  Whether 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_media
  True or false, indicating whether an image was included in the review. 
• review_images
  An array of image URLs, if the reviewer submitted product images. 
• product_external_id
  The 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.
• topic
  The topic of the review, as identified by Klaviyo AI (e.g., “productQuality”). 
• topic_name
  The friendly name of the topic of the review, as identified by Klaviyo AI (e.g., “Product Quality”).
• sentiment
  The review’s sentiment (i.e., “positive” or “negative”).
• snippet
  A portion or summary of the review used by Klaviyo AI to identify its topic and sentiment. 
• subtopic
  Additional information about the review’s topic, as identified by Klaviyo AI. 
• confidence
  The level of confidence Klaviyo AI has that it’s identification of the review’s topic and sentiment is correct (i.e., “low”, “medium”, “high”).
• klaviyo_token
  Your Klaviyo public API key. 

Profile data

If you set up custom review questions, reviewers’ answers will be saved as custom profile properties in Klaviyo. Learn more about how to use profile properties. 

Additional resources

• Getting started with Klaviyo Reviews
• How to export Klaviyo Reviews
• Shopify data reference