PITWALLOSdocs

Events

Eventsis where you announce anything time-boxed happening at your venue — time attacks, leagues, hot-lap challenges, championships. Published events show up on the public /eventspage and in every customer's portal dashboard.

Events are separate from hotlap competitions:

  • A hotlap competitionis a live scoring window — every lap driven inside it automatically scores. Set on the Leaderboards page.
  • An event is a promotional page. It has a cover image, a description, a location, a start/end time, and (optionally) registration. Set here.

Most venues use both together: create the hotlap competition for scoring, then create a matching event to advertise it with photos and a description.

Creating an event

  1. Admin → Events → New event.
  2. Fill in title, description (Markdown supported), cover image URL, location, and start/end times in your venue's timezone.
  3. Pick an event type — this tags it for filtering on the customer-facing listing:
    • Time attack— single-lap hotlap competition.
    • League— multi-round series with cumulative points.
    • Hot-lap challenge— casual, usually week-long attempts.
    • Formula challenge— open-wheel specific.
    • Other— anything else. Watch parties, meet-and-greets.
  4. Choose whether registration is required. If it is, the public page shows a “Register” button that requires the customer to be signed in.
  5. Save as draft first (invisible to customers) or publish straight away.

Registrations

For events with registration on, the admin page shows aRegistrations tab per event: signed-up customer names, emails, timestamps. Export to CSV if you need it in a spreadsheet.

Customers can self-serve unregister up to the event start. After start, they can still unregister via the portal but the row stays in your table flagged as “no-show” for reconciliation.

Draft vs published

  • Draft — is_published is off. Invisible everywhere except the admin console. Use to build up a marketing plan without leaking it.
  • Published — is_published is on. Visible on the public site. Customers can register (if registration open is also on).

Flip an event back to draft to pull it off the public site. For events that were published and then called off entirely, change the title to prefix it with “[Cancelled] …”before flipping to draft — that way anyone who saw the earlier announcement gets a clear signal if they later go looking.

Cover images

Provide a public HTTPS URL. The customer-facing listing renders it at 16:9; anything with a strong horizontal composition works. We recommend hosting on a real CDN (Cloudinary, Imgix, S3) — the image is loaded on every customer visit to the events page.

Marketing your events

Once an event is published, use Reachto email a segment of your customers about it — the campaign composer has an “Event card” block that renders the event with cover image and a register CTA.