> ## Documentation Index
> Fetch the complete documentation index at: https://flywheel.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Definitions

> Create and manage event definitions to control event schemas and display configuration

Event definitions let your team standardize event structure and control how events appear throughout Flywheel.

## What event definitions do

Event definitions help you:

* Keep event names and properties consistent
* Edit display settings (icon, color, description template)
* Review event source and schema details
* Manage custom and Flywheel-provided event definitions

## Open event definitions

Go to **Events** → **Event Definitions** in your dashboard.

<Card title="Open Event Definitions" horizontal icon="database-zap" href="https://app.flywheel.cx/dashboard/deeplink?target=/event-definitions">
  Review and manage event definitions for your workspace.
</Card>

## Create a custom event definition

1. Click **Create Event**
2. Enter an event name (Flywheel converts spaces to underscores)
3. Open the new definition from the list
4. Configure schema fields and display settings

<Note>
  Custom event definitions are editable. Factory event definitions are read-only.
</Note>

## Configure a definition

Inside an event definition drawer, you can configure:

* **Properties**: schema fields used for validation and context
* **Icon & color**: event visual identity in tables and timelines
* **Description template**: dynamic event text based on event properties
* **Description properties**: property mapping used by the description template

## Search and open definitions

On the Event Definitions page, you can:

* Search by event name
* Open any row to view details
* Identify the event source at a glance from source icons

## Best practices

* Use clear, stable event names like `trial_started` or `invoice_paid`
* Keep property schemas simple and strongly typed
* Document important custom properties before sending high-volume traffic
* Update display templates so teammates can quickly interpret events