Understanding Mixpanel’s Limitation on List of Objects

What Is a List of Objects?

A “list of objects” refers to an array of items within an event property. For example, when Vendo sends an Order Received event to Mixpanel, it includes a list of all products in that order:


{
  "event": "Order Received",
  "properties": {
    "items": [
      { "id": "SKU-001", "name": "Blue T-Shirt", "price": 29.99, "quantity": 1 },
      { "id": "SKU-002", "name": "Red Hoodie", "price": 59.99, "quantity": 2 },
      { "id": "SKU-003", "name": "Black Cap", "price": 19.99, "quantity": 1 },
      { "id": "SKU-004", "name": "White Sneakers", "price": 89.99, "quantity": 1 },
      { "id": "SKU-005", "name": "Denim Jeans", "price": 69.99, "quantity": 1 },
      { "id": "SKU-006", "name": "Leather Belt", "price": 34.99, "quantity": 1 }
    ]
  }
}

The Limitation

Warning: By default, Mixpanel only parses the first 5 objects in any list property. Items beyond the 5th position are stored but not available for breakdown reports in the Mixpanel UI.

This means that if an order contains more than 5 line items, or if a collection view event includes more than 5 products, only the first 5 will appear when you break down reports by product properties.

Impact on Your Reports

When this limit applies, you may notice:

Missing products in breakdowns — Reports broken down by product name, SKU, or category will only show the first 5 items per event
Undercounted metrics — The number of times a product was purchased or viewed may appear lower than actual
Discrepancies with source data — Totals in Mixpanel won’t match your Shopify or BigQuery data for orders with 6+ items

Note: Vendo sends all product data to Mixpanel — the limitation is on Mixpanel’s parsing side, not on the data Vendo provides.

How to Request a Limit Increase

Mixpanel can increase the list of objects limit for your project on a case-by-case basis. This is available to customers on a paid Mixpanel plan.

Steps

Contact Mixpanel support by submitting a ticket or emailing support@mixpanel.com
Use the subject line: “Request for List of Objects Limit Increase”
Include the following details in your request:
- Your Mixpanel project name
- Your Mixpanel project ID (found in Project Settings)
- The desired new limit (e.g., 20 or 50 objects)
- A brief explanation of your use case

Sample Email Template


Subject: Request for List of Objects Limit Increase

Hi Mixpanel Support,

We would like to request an increase to the list of objects parsing
limit for our project.

Project Name: [Your Project Name]
Project ID: [Your Project ID]

We use Vendo to stream Shopify e-commerce events to Mixpanel. Many of
our orders contain more than 5 line items, and we need the full product
list to be available for breakdown reports.

Could you please increase our limit to [desired number] objects?

Thank you.

Approval is not guaranteed — Mixpanel reviews each request for feasibility based on your project’s data volume.

Mixpanel Integration Setup — Full setup guide for the Vendo Mixpanel destination