# Event Property

An attribute describing the context or details of one recorded event instance.

- Type: term
- Domain: Data, experimentation & growth
- Level: Foundational
- Last reviewed: 2026-09-24
- Original: [Soroush’s Product Wiki](<https://wiki.soroush.uk/topic/event-property/>)

## What it means

An event property is a key-value attribute attached to a specific occurrence of an action, such as an order’s value, a search’s query length, or an error’s code. Unlike a user property, it describes that event at that moment rather than a characteristic intended to persist across events.

## Why it matters

Properties let teams segment and interpret behavior without creating a separate event name for every variation.

## When to use it

Use properties for context that varies per action. Govern names, types, allowed values, privacy, and cardinality through the tracking plan.

## How it works

1. Define the question the property supports.
2. Choose a stable name, type, and meaning.
3. Attach the value when the event occurs.
4. Validate representative and edge-case values.
5. Document and govern changes over time.

## A practical example

A Completed Checkout event includes payment\_method, item\_count, currency, and order\_value properties, enabling analysis without separate checkout events for every combination.

## Where it breaks

Missing, inconsistent, high-cardinality, or sensitive values can make analysis unreliable or create privacy risk.

## Common mistakes

- Encoding property values in event names.
- Using a current user trait as historical event context.
- Collecting data without a decision use.

## Visualization

[View the visualization on the website](<https://wiki.soroush.uk/topic/event-property/#visualization-event-property>)

## Sources

1. [User properties and event properties](<https://www.amplitude.com/docs/data/user-properties-and-events>) — Amplitude Docs · Official documentation
2. [Official events and properties](<https://amplitude.com/docs/data/official-events-and-properties>) — Amplitude Docs · Official documentation

## Related topics

- [User Property](<https://wiki.soroush.uk/topic/user-property/>)
- [Event Taxonomy](<https://wiki.soroush.uk/topic/event-taxonomy/>)
- [Instrumentation Plan](<https://wiki.soroush.uk/topic/instrumentation-plan/>)
