Event Configuration
Configure and manage your Tagger event model.
Event Configuration is the core of any Tagger workflow. It defines what analysts can tag, how event buttons behave, and which additional context is captured with each tagged action.
Tagger includes system-defined sport configuration templates in the Catalog. These are designed as starting points and reference implementations. In most production environments, analysts should adapt them to match team-specific terminology, coding standards, and reporting requirements.
The Event Configuration area includes:
- Events
- Event Groups
- Event Labels
- Event Links
- Event Accelerators
- Tag Windows
Events
Every event tagged in the Tagger interface is an instance of an Event configuration. Event behavior at runtime depends on the settings defined here.
| Field | Description |
|---|---|
| Name | Required. This is the default label shown on the event button in Tagger. Users can optionally switch display mode to use short names or icons from Preferences. |
| Event Group | Assign each event to an Event Group. This determines where the event button is displayed in the Tagger layout. |
| Enabled | Only enabled events are available for tagging. |
| Primary Event | When enabled, the event appears as a directly selectable button in Tagger without prerequisite selections. Non-primary events are commonly exposed through Event Links. |
| Color | Defines the event button background color. |
| Text Color (White) | Defines event button text color (black or white) to ensure readability against the selected background. |
| Event Labels | Attach one or more Event Labels to capture additional metadata for the event. Example: a Shot event can include labels such as Shot Type (Open Play, Free Kick) and Body Part (Left Foot, Right Foot, Head). |
| Event Team | Controls team assignment behavior for the event instance. Unset defaults to the team panel where the event button is pressed; Team A or Team B always assigns that team; Same always uses the team panel where the event is selected; Opposite assigns the opposing team relative to the panel used. |
| Specify Player for Event | When enabled, a player must be selected before the event can be tagged. |
| Keep Player Active After Event Save | Keeps the selected player active after saving an event. This reduces clicks in sequences where the same player is likely to perform subsequent actions - for example Pass Received followed by the next action from the same player. |
| Specify Position for Event | When enabled, the user must provide event coordinates during tagging. |
| Events Playing Area | Selects the playing area used for coordinate capture. |
| Specify Count for Tag | Allows entry of a quantity for the event in a single action. Example: during live analysis, an analyst can tag Passing once and enter the total count for that sequence. |
| Lead Time | Sets the pre-roll duration (in seconds) when generating or previewing event clips. |
| Lag Time | Sets the post-roll duration (in seconds) when generating or previewing event clips. |
| Icon | Optional icon for the event button. Useful on compact layouts and mobile workflows. Icons can be selected from https://materialdesignicons.com/. |
| Short Name | Optional compact label shown when users enable short-name display mode in Preferences. |
Advanced Button Customization
| Field | Description |
|---|---|
| Custom Button Width | Leave blank or set to auto for default sizing. Set a value from 2 to 12 to control button span. |
| Custom Button Height | Set a custom pixel height. This overrides event button size set in user Preferences. |
| Button Rounded Corners | Controls corner styling. Set to none for square corners. |
| Button Variant | Flat is the default style. Additional options include Outlined and Text. |
Event Groups
Event Groups are categories used to organize event buttons in the Tagger interface.
| Field | Description |
|---|---|
| Name | The display name of the event group. |
| Enabled | Only enabled groups are shown in Tagger. |
Event Labels
Event Labels define additional descriptors that can be attached to events. A single label can be reused across multiple events.
| Field | Description |
|---|---|
| Name | The label name. Example: for a Shot event, create a label called Body Part. |
| Enabled | Only enabled labels are available during tagging. |
| Label Options | Label Options are the selectable values shown at runtime. Example: for the Body Part label, options might include Right Foot, Left Foot, and Head. |
Label Options
| Field | Description |
|---|---|
| Name | The option name. |
| Enabled | Only enabled options are selectable. |
| Color | Defines the label option button background color. |
| Text Color (White) | Defines label option text color (black or white). |
| Icon | Optional icon for the label option. Icons can be selected from https://materialdesignicons.com/. |
| Short Name | Optional compact label shown when short-name mode is enabled. |
Event Links
Event Links allow one event to activate other events automatically.
Example: Selecting Shot can activate Goal and Wide as follow-up options.
In this context, activate means the linked events become visible and selectable when the source event is selected.
| Field | Description |
|---|---|
| Name | The link name. |
| Enabled | Only enabled links are applied. |
| From Event | The source event that triggers activation. |
| Link Direction | Defines whether activation is one-way or bidirectional. One Way: From Event to To Event only. Two Way: activation works in both directions. |
| To Event | The target event that is activated by the link. |
Event Accelerators
Event Accelerators speed up tagging by selecting predefined events and labels with one click.
| Field | Description |
|---|---|
| Name | The accelerator name shown in Tagger. |
| Event Group | The Event Group where the accelerator is displayed. |
| Enabled | Only enabled accelerators are available. |
| Event Selections | A list of events selected automatically by the accelerator. The order of Event Selections is important because it determines the sequence in the events table. |
Event Selections
| Field | Description |
|---|---|
| Event Selection | The event included in the accelerator. |
| Enabled | Only enabled selections are applied. |
| Labels | Labels and label options that are automatically selected when the accelerator is used. |
Labels
| Field | Description |
|---|---|
| Event Label | The label to apply. |
| Event Label Option | The label option value to apply automatically. |
Tag Windows
Tag Windows allow you to create focused windows for tagging specific events. Each window displays only the events you choose, so an analyst can concentrate on a subset of the event buttons — for example their own team's events, or a particular phase of play. They are particularly useful for teams using Tagger Rooms for multi-user tagging and live sharing.
Tag windows are selected at tagging time from the Tag Windows dialog, opened with the panel icon at the top of the event buttons.
| Field | Description |
|---|---|
| Tag Window Name | Required. The name shown on the button in the Tag Windows dialog. |
| Enabled | Only enabled tag windows are available in the Tag Windows dialog. |
| Display | Both, Team A or Team B — controls which team windows are shown. |
| Events | Required. The events that this tag window will display. |
See Tag Windows for the tagging workflow, including how to swap the sides of the tagging screen.
