This article walks you through telling ROLLER Karting which ROLLER resources and products to bring across, and which run template to use for each one. Once mapping is set up, every booking made in ROLLER for a karting product automatically creates the right kind of race on your ROLLER Karting schedule.
About mapping
Most ROLLER venues sell more than just karting: laser tag, trampolines, escape rooms, party packages, and so on. ROLLER Karting only needs to know about the bookings that involve a race, so you tell it which of your ROLLER resources and products to pay attention to.
Mapping has two parts:
Resource mapping — for each ROLLER resource that represents a track (for example, Karting Track, Junior Track), pick the matching calendar in ROLLER Karting. Anything you don't map is ignored, which is what you want for non-race resources.
Product mapping — for each ROLLER product that should create a race (for example, Karting Full Track Adult, 10 Lap Junior Race), pick the matching run template in ROLLER Karting. Unmapped products are silently ignored.
Once both are set, bookings flow through automatically: a guest books a karting product in ROLLER, the booking pops onto the ROLLER Karting schedule at the correct time on the correct calendar, and the racer's name appears once their waiver is signed.
Before you begin
ROLLER Karting is installed and connected to ROLLER. See Install ROLLER Karting if you haven't completed the integration yet.
Your race track is set up in ROLLER Karting (loops, timing source, and at least one course). See Set up your race track in ROLLER Karting if you haven't done this yet.
You've created the run templates you want bookings to use. See Create a run template in ROLLER Karting. Product mapping requires at least one run template to exist.
You've decided which of your ROLLER resources represent races. Resources like trampolines, laser tag, or escape rooms should not be mapped.
Your ROLLER Karting calendars are set up under Settings > General > Calendars and match the tracks you offer.
Step 1: Open the integration
Open the ROLLER integration in ROLLER Karting to access the mapping screens. Follow the steps below:
From the left menu, go to Settings.
Under the Integrations & Advanced Setup header, select Integrations.
In the list, select the pencil icon next to your existing ROLLER integration.
The Edit "ROLLER" Integration dialog opens. The Resource to Calendar and Product Variation to Run Template sections appear further down the dialog.
.png)
Step 2: Map your resources
Tell ROLLER Karting which ROLLER resources represent races, and which Karting calendar each one runs on. This is done in ROLLER Karting. Follow the steps below:
Scroll to the Resource to Calendar section. You'll see every resource from your ROLLER instance listed, including ones you don't care about (trampolines, escape rooms, and so on). Unmapped resources show with an empty dropdown by default.
For each resource that represents a race, use the dropdown to select the matching ROLLER Karting calendar. For example, map Karting Track to Main Track, or Junior Track to Junior Track Calendar.
Leave every other resource unmapped, or explicitly select Not mapped in the dropdown. Anything you don't map is ignored by the sync, which is exactly what you want for non-race activities.
If you map a resource by mistake, change the dropdown to Not mapped and it will be ignored.
Example: A multi-activity venue with karting, trampolines, and laser tag would map only Karting Track to Main Track and leave the other resources unmapped.
Step 3: Map your product variations to run templates
Tell ROLLER Karting which ROLLER product variations should create races, and which run template each one should use. Products in ROLLER are made up of one or more variations (for example, adult and child versions of the same karting product), and each variation is mapped independently. This is done in ROLLER Karting. Follow the steps below:
Scroll to the Product Variation to Run Template section. You'll see every product variation from your ROLLER instance listed. Unmapped variations show with an empty dropdown by default, alongside the product variation name.
For each variation that should create a race in ROLLER Karting, use the dropdown to select the matching run template. For example, map Karting Full Track Adult to Adult 15 Lap Race, or Karting Junior 10 Min to Junior 10 Min Race.
If a product has multiple variations (for example, adult and child versions), each variation appears as its own row and can be mapped to a different run template.
Leave every other variation unmapped, or explicitly select Not mapped. Unmapped variations won't create races, and bookings against them won't appear on the ROLLER Karting schedule.
Product variation mapping is the most commonly missed step on first setup. If a venue's bookings show up in ROLLER but don't appear on the ROLLER Karting schedule, the variation is almost always unmapped here.
Step 4: Save
Select Save at the bottom of the integration screen. ROLLER Karting verifies the mapping. If anything is wrong (for example, missing credentials), you'll see an error message describing what to fix. Otherwise, your mapping is live immediately.
Step 5: Test the flow
Confirm bookings flow from ROLLER through to your ROLLER Karting schedule. Follow the steps below:
In ROLLER, make a test booking for one of the products you just mapped, at a time slot in the near future.
Switch to ROLLER Karting and open the Schedule. The booking should appear at the correct time on the calendar you mapped to, using the run template you selected. A guest placeholder shows in the participant list.
Back in ROLLER POS, assign a waiver to the booking. The guest placeholder on the ROLLER Karting schedule updates to show the racer's name.
Cancel or delete the test booking when you're done, so it doesn't sit on the schedule.
.png)
If the booking doesn't appear in ROLLER Karting, check that the product is mapped (Step 3) and that the resource is mapped to the calendar you're looking at (Step 2).
Update mappings later
You'll come back to the integration any time your product lineup changes in ROLLER. Follow the same workflow:
When you add a new karting product in ROLLER. Go to Settings > Integrations & Advanced Setup > Integrations > ROLLER (pencil icon), scroll to the Product Variation to Run Template section, and map each new variation to the right run template. Save.
When you create a new run template. Existing product mappings stay as they are. If you want existing products to use the new template, come back to the Product Variation to Run Template section and update them.
When you take a booking before mapping is complete. ROLLER Karting only acts on bookings when they fire a webhook. Bookings made before a product was mapped won't appear retroactively. To bring them across, open each booking in ROLLER POS and make a small edit (for example, re-save the booking). That re-fires the webhook and ROLLER Karting picks it up.
Frequently asked questions
A booking I made in ROLLER isn't appearing in ROLLER Karting. What went wrong?
The most common cause is that the product variation isn't mapped. Open Settings > Integrations & Advanced Setup > Integrations, select the pencil icon next to ROLLER, and check the Product Variation to Run Template section. The booking's variation needs a run template selected. Also confirm that the variation's resource is mapped to a calendar in the Resource to Calendar section. If both are set and the booking still doesn't appear, re-save the booking in ROLLER POS to re-fire the webhook.
A new product showed up in ROLLER. Will it map automatically?
No. New products always start as Not mapped. You'll see them when you next edit the integration and can assign them to a run template. Until you do, bookings against the new product won't create races in ROLLER Karting.
Can I map one ROLLER product to more than one run template?
No. Each product maps to a single run template. If you need different races for the same product (for example, adult vs junior age splits), use product variations in ROLLER and map each variation to its own run template.
Can the racer's name show up before the waiver is signed?
No. A guest placeholder appears on the schedule when the booking syncs across, but the racer's name only populates once a waiver is signed in ROLLER POS. This is intentional. Karting venues need a signed waiver before a racer can take to the track.
What if a booking has multiple guests?
Each guest needs their own waiver. A waiver link is sent to everyone in the booking, and each signed waiver appears separately in ROLLER POS. Assign each waiver to its guest on the booking, and each racer's name will populate on the ROLLER Karting schedule as their waiver is assigned.
What's next
With install, race track setup, run templates, and mapping all in place, bookings flow into ROLLER Karting automatically. Two setup tasks remain:
Add your karts, so staff can assign each racer to a vehicle.
Set up display screens for the live race view in your venue.
With those in place, you're ready to run races: starting races, assigning racers, and handling results.