Understanding Mixpanel's Limitation on List of Objects

What Is a List of Objects?

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

{
  "event": "Order Received",
  "properties": {
    "products": [
      {
        "id": "SKU-001",
        "title": "Blue T-Shirt",
        "price": 29.99,
        "quantity": 1
      },
      { "id": "SKU-002", "title": "Red Hoodie", "price": 59.99, "quantity": 2 },
      { "id": "SKU-003", "title": "Black Cap", "price": 19.99, "quantity": 1 },
      {
        "id": "SKU-004",
        "title": "White Sneakers",
        "price": 89.99,
        "quantity": 1
      },
      { "id": "SKU-005", "title": "Denim Jeans", "price": 69.99, "quantity": 1 },
      { "id": "SKU-006", "title": "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.

If an order has more than 5 line items, only the first 5 appear when you break down reports by product properties. The same applies when a collection view event has more than 5 products.

Impact on Your Reports

When this limit applies, you may notice:

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

Note: Vendo sends up to 20 products in the product list of each event. The 5-object limit is on the Mixpanel parsing side, not on the data that 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

1. Contact Mixpanel support. Submit a ticket or send an email to support@mixpanel.com.
2. Use this subject line: “Request for List of Objects Limit Increase”
3. Include these details in your request:
   • Your Mixpanel project name
   • Your Mixpanel project ID (found in Project Settings)
   • The new limit that you want (for example, 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.

Related

• Mixpanel destination setup: Full setup guide for the Vendo Mixpanel destination