HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
These docs are for v1-2. Click to read the latest docs for v2024-02-15.

Generate sample data

Learn how to use the Sample Data Generation Tool to populate your Klaviyo account with three types of sample data: Klaviyo, custom ecommerce integration, and catalog data.

Klaviyo’s Sample Data Generation Tool enables you to populate your sandbox account with data for testing purposes. Three types of data are available to create: Klaviyo, custom ecommerce integration, and catalog data.

📘

Please ensure you are in the correct account before generating data. We recommend a dedicated account for testing purposes. Learn how to create a sandbox account.

Generate sample data

  1. Open the Sample Data Generation Tool
  2. Select the type(s) of data you want to create:
    a. Check the box next to Klaviyo Data to generate sample customer profiles, email events, and SMS events
    b. Check the box next to eCommerce Data to create ecommerce events on sample profiles, such as Added to Cart and Cancelled Order
    c. Check the box next to Catalog Data to populate a catalog with sample product items
  3. When you are satisfied with your selections, click Add Data.

🚧

The data generation tool can only be used to create sample data one time per data type. Any data not yet generated can be created at a later time by reaccessing the tool. Data types that were already created will be disabled.

Image of the Select Data Type modal with all three data types selected: Klaviyo data, ecommerce data, and catalog data

Data will populate in your account shortly. A green success message will appear when generation is complete. Once the data is created, you can see an overview of the sample data in the sections below. Rarely, the tool may fail to generate all or part of the data requested. If you receive an error message, refresh the page and re-attempt generating data following the steps above.

Sample profiles & events

The sample data tool generates 10 sample profiles, which can be viewed in the Sample Profiles and Events section of the tool. Here you can view the name for each profile, as well as if Klaviyo events and ecommerce events were created for that profile. Each profile also includes the Created timestamp. To view additional details of the events for these profiles, click View Metrics.

Read more about the Klaviyo data and custom ecommerce integration data created by this tool.

Image of the Sample Profiles & Events modal, displaying 10 profiles alongside their created at timestamp

Sample catalog items

The sample data tool generates 15 catalog items. Each item is named with (Sample) and the Item ID: SAMPLE-DATA-ITEM-## to differentiate it from your other catalog data. To view all items in your catalog, click View Catalog to access the catalog tab.

Read more about the catalog data created by this tool.

Image of the Sample Catalog Products modal, displaying 15 catalog items alongside their created at timestamp

Delete catalog data

If you wish to import your own custom catalog into an account later, the sample catalog items generated by the tool need to be deleted. If you need to delete the sample catalog data:

  1. Scroll to the bottom of the Sample Catalog Items modal
  2. Click Delete Sample Catalog Data
  3. Click the Continue button to confirm your choice

A green success message will appear when the sample data is successfully deleted.

Klaviyo data

The Klaviyo data generated by the tool includes the following:

Sample dataQuantity
Profile10

Read more about Klaviyo profiles.

The email data generated by the tool includes the following events:

Event Quantity
Received Email10
Opened Email5
Clicked Email2
Bounced Email2
Dropped Email1
Marked Email as Spam1
Unsubscribed1

Read more about understanding email metrics.

The SMS data generated by the tool includes the following events:

Event Quantity
Consented to Receive SMS10
Received SMS10
Sent SMS2
Clicked SMS1
Failed to Deliver SMS1
Received Automated Response SMS1
Failed to Deliver Automated Response SMS1
Unsubscribed from SMS1

Read more about Klaviyo SMS metrics.

Custom ecommerce integration data

The ecommerce data generated by the tool includes the follow events:

EventQuantity
Active on Site9
Viewed Product16
Added to Cart7
Started Checkout6
Placed Order5
Ordered Product10
Fulfilled Order2
Cancelled Order2
Refunded Order2

Read more about custom ecommerce integration data.

Catalog data

The catalog data generated by the tool includes the following data for each catalog item:

  • Item ID (e.g. SAMPLE-DATA-ITEM-10)
  • Status
  • Added On
  • Last Updated
  • Category
  • Description

Next steps

Make a test API request
Use custom catalog data in emails