Managing events

Events are the core unit of work in RaceRanger. Each event represents a race weekend or competition and contains one or more races.

Creating a new event

1. From the web interface or the app, navigate to your organisation's events.
2. Tap Create Event.
3. Fill in the event details:
   • Name — the event title.
   • Location — city, country, and map coordinates.
   • Dates — start and end dates.
   • Event URL — optional link to the event website.
   • Event size — small, medium, or large (see the table below).
   • Sport — inherited from the organisation, but can be overridden.
4. Save the event. It's now visible to anyone assigned to it.

If your organisation has an API integration, some of these fields may be pre-filled automatically when you search for an event — and you may be able to import events outright; see Full details below.

Event size and features

The event size tier determines what's available:

Size	Races	Users	Chat	Voice commands
Small	Limited	Limited	No	No
Medium	More	More	Yes	Yes
Large	Unlimited	Unlimited	Yes	Yes

Features like chat and voice commands are automatically enabled or disabled based on the event size. There's no separate toggle for these.

Event states

Events move through these states:

• Active — the event is live and officials can access it.
• Archived — the event is over. Data is preserved but the event moves out of the active list.

Event documents

Attach PDF documents (competition rules, briefing notes, emergency procedures) so every official can read them in the app — details in Event setup.

Full details

Everything below is optional reading — open a section when you need it.

Importing events from your timing system

If your organisation has event import enabled, you can search for and import events directly from the organisations page, without going through the Create Event form. The search marks events you've already imported so you don't import the same one twice.

You can select more than one result before importing to combine them into a single event — the first is the main event and the rest are merged into it. If the event you want isn't in the search, choose Add manual event to enter it by hand.

If new races are added to the timing system after you've imported an event, open the event editor and choose Reimport / fill missing races to pull them in. For events combined from more than one source, this refreshes every linked source. Races you already have are left untouched.

The Edit Event tabs in detail

Open the event from the events list and tap Edit Event in the left column of the event detail page. A modal opens with the same fields as the create-event flow, organised into six tabs: Basics, Location, Dates, Extras, API keys, and Webhooks. Changes take effect immediately for all assigned users after Save event is tapped.

The Extras tab is where the event size tier lives — that one toggle controls how many races, users, chat, and voice features the event has. The invite code (which athletes and officials use to self-join the event) is also editable here.

The API keys tab manages event-scoped keys for connecting external tools to live race data — see API authentication.

The Webhooks tab lets external systems receive live event updates (penalties, incidents, race status changes) — see Webhooks.