Configuration
A guide to Tagger configurations — what they are, how they are managed, and how to modify and test them for your own analysis.
What is a Configuration?
A configuration is the foundation of every Tagger game. It defines what can be tagged, how events are captured, how data is measured and calculated, and how results are presented.
Each configuration specifies:
- What can be tagged — the events (Shot, Pass, Turnover, etc.) and their associated labels and attributes
- How it is tagged — how event buttons behave and which player, zone or outcome context is captured with each action
- Measures and calculations — the totals, metrics and formulas derived from your tagged data
- Presentation — how results are displayed in charts, totals, info cards, comparison tables, dashboards and more
Pretty much everything in Tagger is configurable, from events and playing area graphics to charts, totals and dashboards.
At the core of every configuration is the Event. Your Shot, Pass, Turnover and similar actions are the building blocks for other configuration objects, including totals, charts, info cards, comparison tables and event sources.
The following pages provide details on each configuration section:
- General Configuration
- Playing Area Configuration
- Zone Configuration
- Event Configuration
- Event Config Visualiser
- Tag Windows
- Score Configuration
- Total Configuration
- Comparison Tables Configuration
- Info Cards Configuration
- Position Maps Configuration
- Charts Configuration
- Totals-based Charts
- Shortcuts Configuration
- Metric Highlights
- Metric Progressions
- Event Sources
Configuration Management
Tagger provides a number of pre-defined Sport Configuration templates in the Configuration Catalog. To get started quickly, import a configuration from the Catalog and then adapt the template to your own specific analysis.
Configurations are saved locally in the app and are not automatically backed up to cloud storage or anywhere else. Back up your configuration templates regularly — either to your local file system or to your Cloud Workspace — to avoid losing your work.
Template vs Game Configuration
Tagger distinguishes between a Template Configuration and a Game Configuration.
When you create a new game, you first link it to a Template Configuration.

In the Configurations list, a green tick next to the template indicates that the current game is linked to it.

When the game is saved, the Template Configuration is saved along with the game data and becomes a Game Configuration. When you reopen the game, its Game Configuration opens with it, and in the Configurations section the configuration is labelled as a Game.

Modifying and testing configurations
There are three approaches to modifying templates, depending on whether you have a game available to test against:
- Link a game to a Template Configuration — the recommended approach when you have an existing game you can test with
- Modify a Game Configuration and convert it to a template — the recommended approach when you want to test changes before reusing them
- Directly change a Template Configuration — only suitable when you have no existing games to test with
1. Link a Game to a Template
This approach is ideal when you have a game you can use to test changes against real data.
- Open a game.
- From the game menu, click Edit.
- Change the Sport Configuration to use the Template Configuration instead of the Game Configuration.
- Go to the Configurations list and start making changes to the template.
Any changes you make to the template are applied immediately and will be available for future games.
2. Modify a Game Configuration
This approach lets you test changes against a live game before turning them into a reusable template.
- Open a game and navigate to Configurations.
- Modify the Game Configuration as required.
- Once you have tested the changes and are happy with them, copy the Game Configuration to create a new Template Configuration:
- In the Configurations list, open the menu (the blue button with three dots) on the Game Configuration.
- Click Copy and give the new template a name. As good practice, include a version number in the name (e.g.
v1).
You now have a new template that you can use for other games going forward.
3. Directly change a Template Configuration
If you do not yet have any games, you can still modify a Template Configuration for use with new games.
The main drawback of this approach is that you will not have any event data to test with, so approaches 1 and 2 are recommended whenever possible.