---
title: How to Create an Event
slug: docs.otrax.app
createdAt: 2023-06-19T23:02:52.000Z
---

:::hint{type="info"}
**NOTE**

Even after they are uploaded, the course details of an event that is marked as a "Competition" will **not be visible** to or accessible by anyone, other than the event creator, until after the event. But having them uploaded in advance means that people can upload their runs immediately.
:::

::::ExpandableHeading{isOpen="true"}
## Prerequisites

### IOF XML file

- [OCAD: Export IOF XML](https://docs.otrax.app/ocad/export-iof-xml)

### Map and World Files (optional, but preferred)

:::hint{type="info"}
Maps images should be exported without any controls as OTrax will overlay the controls and courses as required
:::

- [OCAD: Export Map Overlay](https://docs.otrax.app/ocad/export-map-overlay)
::::

## Instructions

:::::WorkflowBlock
:::WorkflowBlockItem
Browse to [https://otrax.app/#/events](https://otrax.app/#/events)

Click **Create Event** (top right)
:::

::::WorkflowBlockItem
Select the IOF XML file.

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/WhKsantuZt-apvtSqBKa1_image.png "Event file upload screen")

:::hint{type="info"}
**NOTE**

If the source is not georeferenced, with a projection set, the v3.0 IOF XML file upload will give an error as it will not contain sufficient information to place it on the map. In this case exporting as v2.0.3 may prove better as it may contain enough information when used with a selected projection.
:::

- If asked, select the projection used in the file (most likely NZTM2000).
- If there is an error here, it's possible that the source file is not correctly georeferenced. Please check the documentation of your mapping/planning software for details on how to configure this.
- It should then show a satellite map with all the control locations overlayed.
  - Please check locations look correct

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/cKdwdTXPQ9Wkv4TR6uCjm_image.png "Satellite map showing control locations")
::::

:::WorkflowBlockItem
Fill in the event details be sure to set it as a **Public Event** and a **Competition**

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/GWsFjQMgUJj6eNtaG5aFd_image.png "Event details screen")

Click **Next**
:::

:::WorkflowBlockItem
Select the map image (png/gif/jpg) and world file (pgw/gfw/jgw)

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/NVs8e5dXKjGnNSS0QrblO_image.png "Map overlay screen before files are upoaded")

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/tiIEHT846_ZQPMlQK_tFK_image.png "Map overlay screen with files uploaded")

- Select the projection that the map was created in (most likely NZTM2000)
- The map should be displayed overlaid on the satellite image
  - Please check that it is placed correctly

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/K47tUz88X-ABd3srPFEEh_image.png "Map overlay screen showing map preview")

Click **Next**
:::

:::WorkflowBlockItem
Check that all controls are in the correct location and edit if necessary.

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/1eWNy16Le-PD40Lajc6oj_image.png "Event Controls")

Click **Next**
:::

:::WorkflowBlockItem
Check all the courses look OK and modify if necessary

![](https://api.archbee.com/api/optimize/5ls5w9Rk8DQPr5opCg6CW/ptUS5FErNwmMqZGk1tBHn_image.png "Course list")
:::

:::WorkflowBlockItem
Click **Create Now** and you're done
:::

:::WorkflowBlockItem
After creating the event, *please link to it on your website's results page and in social media*, so that runners know that it's ready for them to upload their tracks.

::Image[]{src="https://otrax.app/assets/compare-routes-logo.svg" size="26" width="175" height="32" position="center" caption="https://otrax.app/assets/compare-routes-logo.svg" showCaption="true"}

You may use the above image along with the link to [https://otrax.app/#/events](https://otrax.app/#/events) or the specific link to your event.

```html
<a href="https://otrax.app/#/events" style="text-decoration: none;color:inherit;"><img src="https://otrax.app/assets/compare-routes-logo.svg"/></a>
```
:::
:::::



