List Properties

This article discusses list properties. It defines a list property, and shows you how to create and use list properties.

List Property Definition

A list property contains a list or array of several property contained in one value.

You would want to use list properties whenever you have more than one value for a given property. Here are a few examples of list properties:

  • All the Items purchased in a “Checkout completed” event.
  • Multiple artists for a “Song Played” event.
  • Experiment groupings for A/B testing.
  • Genres of music in a listener’s preferences.

The list type properties limit is 2mb.

Create a List Property

When you want to send a property as a list, you must ensure the property is a JSON array in a valid Mixpanel format.

To build a list property, send an array as a property using mixpanel.track.

Here’s a JavaScript sample code snippet:

mixpanel.track("event name", {"List Property Name":["Item 1", "Item 2", "Item 3", "Item 4"]});

List Property Use Cases

When you analyze a list property in Insights, Mixpanel automatically segments your data by each of the items in the list.

Let’s walk through a few examples of business questions you can answer using list properties. For these examples, let’s use a simple example: a website where shoppers can purchase groceries online called FreshSite.

Now, let’s consider some business questions list properties can help FreshSite answer.

The Amount of Loaves of Sourdough Bread Sold Last Month

To answer this question, segment the data by the list property. Mixpanel will segment list data by the individual values, rather than the complete list.

In this example, when segmenting the “Checkout” event by “Products”, you will see that FreshSite sold 404 loaves of sourdough bread in February 2015.

The Amount of Purchases Last Month That Included Bread

For this question, you want to typecast our list property as a string to allow filtering of the data by certain words (often a substring), rather than an entire string.

You can then search for a certain substring or list element, and the Insights report will pull how many times an event had a value in its list that contained that substring.

As you can see, there were 541 purchases in February 2015 that included bread. You now know from the previous chart that there were 404 sourdoughs, 75 whole wheats, and 62 challahs across 541 purchases. If a user buys bread, they only buy one kind of bread.

With Retention and list properties, FreshSite can easily see if specific items are purchased multiple times. It’s great to know not only if users are loyal to your company, but also loyal to specific products.


Users often look at a series of pages on your site before they perform that one crucial action, such as a purchase.

FreshSite users might view numerous pages before they decide to register and then later purchase. You want to know what paths lead to higher conversions, so that you can guide users through a specific flow and increase the conversion rate.

To do this, you use list properties and send a list of all of the pages on a site the user has taken before they converted.

For this example, you want to know what paths lead to the highest conversion for purchases. You can assign each page on the website an identification number, and add each page number to a list.

When you send the purchase event, add the page numbers list as a property. Now, in an Insights report, you can see the most popular pages for users who made a purchase on the website.

check out

Is this article helpful?
4 out of 13 found this helpful



Please sign in to leave a comment.