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.

Open Event Definitions

Review and manage event definitions for your workspace.

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

Custom event definitions are editable. Factory event definitions are read-only.

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