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. This determines the number of races, users, and which features are available.
   • Sport — inherited from the organisation, but can be overridden.
4. Save the event.

If your organisation has an API integration, some of these fields may be pre-filled automatically when you search for an event.

If your organisation has event import enabled, you can also 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.

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. Races you already have are left untouched.

The event is now visible to anyone assigned to it.

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.

Editing an existing event

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 lets you create, rotate, and revoke event-scoped API keys for connecting external tools to live race data. Each key shows its name, permissions, and status; the plaintext key is shown once on creation.

The Webhooks tab lets you subscribe HTTPS endpoints to receive live event updates — penalties, incidents, race status changes, and more. Each webhook has a signing secret shown once on creation and rotatable at any time.

Event documents

Attach PDF documents to the event for easy access by all officials. Common documents include:

• Competition rules
• Course maps
• Officials' briefing notes
• Local organising committee contacts
• Emergency procedures