> ## Documentation Index
> Fetch the complete documentation index at: https://statsig-4b2ff144-mintlify-java-core-statsig-options-migrati.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Property

> Break down metrics into dimensions for detailed analysis using event properties and metadata fields.

Statsig enables you to breakdown metrics into a single set of non-overlapping dimensions for deep dive analyses.

For example, you can breakdown an event such as **add-to-cart** into product categories such as *sports*, *toys*, *appliances*, *electronics*. To do this, you would simply log **add-to-cart** events and provide the product category in the event's **value** field. See the [Statsig SDK reference guide](/client/javascript-sdk#event-logging) to learn more.

Statsig enables you to define up to four custom dimensions for an event (one via the **value** field and three via **metadata** fields). To configure these custom event fields, go to **Metrics** --> **Events**, select the event you want to configure, and then go to the **Setup** tab for that event.

<Frame>
  <img src="https://user-images.githubusercontent.com/101903926/209886245-c26f569b-a4d4-4882-9d9c-f65f3c1ba43b.png" alt="Event property configuration" />
</Frame>

Providing custom dimensions with logged events allows you to break down the impact on the total **add-to-cart** events by category in Pulse as shown below. This enables you to zero in on the category that's most impacted by your experiment.

<Frame>
  <img src="https://user-images.githubusercontent.com/1315028/162332284-259ea614-8cb6-4c9d-aebd-3e41f9092a64.png" alt="Pulse results breakdown by product category" />
</Frame>

Statsig recommends keeping the number of distinct dimensions in your logging less than 8. This is because tracking dimensions involves additional computational and storage resources, so we prioritize notable dimensions that make up a significant portion of your traffic. As a rule of thumb, we track dimensions that make up >5% of your total event volume. We don't track lower frequency dimensions since they generally have larger degrees of statistical noise and wider confidence intervals. We will bucket them in an "Other" bucket.

Statsig also supports metric dimensions for custom metrics that are **Aggregations**. To set this up, log your dimension as a **value** and the number to be tallied as a metadata field.

This is the old metric dimension page. We renamed it to Event Property.