Skip to main content

Creating events

There is an introductory video that shows an event being set up.

Stages in adding an event

Adding an event

Event details

  • Name: Enter the event name. It is helpful to include the map name since this makes finding past events on the same area much easier. So prefer Ace of Herts: Ashridge over Ace of Herts. The date of the event will be included automatically on the Event tab.
  • Map: Select a map from the dropdown menu. Maps must be added through the Map tab before an event can be set up. It is possible to reuse previously uploaded maps by selecting from the dropdown menu.
  • Club: Enter the organising club.
  • Date: Select the event date.
  • Level: Select the event level from the dropdown menu.
  • Comments: Add any comments you want to make.

Results file

Results file

Select the results file to be used.

Events with no results

The checkbox option for No results file allows you to set up an event with no results file. Results will instead be created when each runner draws or uploads a route.

Result file sorting

The checkbox option for Sort results file should not normally be needed, and it is better to make sure that the results file itself is sorted as you want it. If you do use the checkbox then it will sort by course, then position, then time and then name. If your results file is by class and several classes run one course then sorting within Routegadget is not a good idea, since all the position 1s will come first, followed by all the position 2s and so on.

Course file

Course file

Select the course file to be used.

Relays, score events and butterfly loops

The default event set-up assumes that courses are line courses where every runner visits the same controls in the same order. For other types of event select the Individual courses checkbox.


This checkbox applies to all courses for a Routegadget event. If you put on an event which has line courses and score courses then it it is best to set it up as two separate events in Routegadget.

Adding class information

Adding classes

If your course file is set up with courses names and a mapping to classes then the Add classes to course names checkbox will be displayed. This will update the saved course name to include classes. You can see how this will appear in the result to course mappings.

Aligning controls to the map

If you have a georeferenced map and course file then the controls will be automatically aligned when you import them.

If the map is not georeferenced then the controls and map will need to be manually aligned:

  1. Select two controls to reposition to align all controls. (For example bottom-left and top-right controls on map).
  2. Click-and-drag a control to its correct location on the map and release the click. (Note: left-click-and drag moves the controls layer. right-click-and-drag moves the map layer. Use the Move map and controls together checkbox to drag both layers.)
  3. Click-to-lock - Lock that control in its position by single-clicking the control. The control will display a red-dot indicator to show it is locked.
  4. Click-and-drag another control to its correct location on the map and release the click. All controls will scale to fit.
  5. Single-click the red-dot locked indicator to unlock it.
  6. Check the other control positions and if needed use the click-and-drag or lock-and-resize to get all controls placed correctly.

Drawing a course

The Draw course button allows you to draw a course if you do not have a course file available. This has very limited functionality and only supports one course for an event. It is intended to be used for low-key events with no splits, so that the course just consists of a start and a finish.

Map results to courses

Map results to course

These dropdown boxes are only displayed once you have loaded results and courses.

If the results file and course file uses the same names for each course then this mapping will be done automatically. If not then you can set the required mapping using the dropdowns.


It is possible to select Do not save in the dropdown. This allows you to include only some of the courses and results. For example, this might be useful if shorter courses used a different map and will be set up as a different event.

Create the event

Create event

Select the Read-only checkbox if required. People will be able to see the map, courses and results but they will not be able to draw routes. This will allow you to check that everything has been set up correctly. The event can also be locked and unlocked on the Edit event tab.

Then click Create event. The event will be created and will open in a new tab (if allowed by your browser settings).

Results files

Routegadget supports results files in two formats: csv and IOF XML.

CSV format

Routegadget reads the first line of a CSV file, which is assumed to be column headers, and tries to identify all the necessary fields. Sportident CSV files, or any other CSV file that meets the BOF results file requirements should work.

Your CSV file must as a minimum have columns with the following names:

  • Database Id or si card or sicard or chipno
  • Surname
  • First name
  • Start
  • Time
  • Classifier or nc
  • City or Club
  • Short
  • Course
  • Course controls
  • Place or Pl
  • Start punch
  • Control1
  • Punch1
  • Control2

Routegadget will automatically detect if you are using commas or semicolons as the separator.

If you are using Autodownload then you need to generate the file using the "Export OE splits" option.

Emit Spklasse.csv files are also supported but you are strongly encouraged not to use them. They do not contain much of the useful detail (such as finish position and finish status) that other formats include.

IOF XML format

Routegadget supports results in IOF XML 2.0.3 and IOF XML 3.0 format.

Course files

Routegadget supports courses in IOF XML 2.0.3 and IOF XML 3.0 format. These can be generated from the standard course planning software packages such as OCAD, Condes and Purple Pen.