Fireknife Documentation

Everything you need to set up, configure, and operate the Fireknife reservation and ticketing platform — for admins, agents, and external partners.

Core concepts

Before diving into setup, it helps to understand how Fireknife organizes its data. Every object in the platform builds on the ones beneath it.

User roles

Fireknife supports four distinct roles. Roles are assigned per venue, so a user can have different permissions across venues.

Step 1 — Create a Venue

Navigate to Venues in the left sidebar and click the + button.

Click Save. The venue edit page also shows an Onboarding section with the JavaScript widget snippet — you'll use this when embedding bookings on your website.

Step 2 — Set up payment methods

From the Venues list, click the Payment methods icon next to a venue.

A typical setup includes a public Card method (Stripe, 2.9% + $0.30) and agent-only Cash and Inhouse methods.

Step 3 — Create a Show

Navigate to Shows and click +. Shows are configured across four tabs.

Main info

Show details

Other information

Fees

Add fees or taxes that apply on top of the base ticket price. Each fee has a name, an "Is Tax" toggle, a percentage, and a USD amount. The calculation order is: Net → Fees → Taxes → Payment processing fees.

Step 4 — Add ticket options

From the Shows list, click the ⋮ menu on a show and select Ticket options. These define the passenger categories guests can select at checkout.

Step 5 — Add ticket types

From the ⋮ menu, select Ticket types. These define the seating tiers available at checkout.

Step 6 — Configure the seat map

From the ⋮ menu, select Seats. A visual canvas editor lets you place seats relative to the stage. Each seat has the following properties:

Use the toolbar controls to zoom in, zoom out, and reset the view. Use the download button to export the seat map.

Step 7 — Add timeslots

From the ⋮ menu or the clock icon on a show card, open Timeslots. A calendar view shows the current month.

• Click + to add a new timeslot manually — set the start date/time and confirm the show.
• Click an existing timeslot chip to edit its start time.
• Click the × on a timeslot chip to delete it.

Use the month navigation arrows to move forward or backward. The download icon exports timeslot data to a file.

Step 8 — Set up commission groups

From the ⋮ menu on a show, select Commission Groups. Commission groups define how external agents are compensated for bookings they generate.

After saving, a Commission Matrix appears. Set the commission for each combination of ticket type and ticket option — either as a % or a fixed USD amount. Leave a cell blank to apply no commission for that combination.

Step 9 — Add users to a venue

From the Venues list, click the Users icon next to a venue, then click + to invite a user. Enter their name, email address, and select a role.

Step 10 — Embed the booking widget

The Fireknife booking widget can be embedded on any website. On the venue edit page, scroll to the Onboarding section to find your specific embed code.

1. Add the widget script

Paste this snippet before the closing </body> tag of your website:

<script type="module" src="https://widget-staging.fire-knife.com/index.js"></script>
<div id="fireknife-widget-root"></div>

2. Trigger the booking modal

To open the booking flow from a button or link, call the following JavaScript function. Replace SHOW_ID with the numeric ID of your show:

window.showFireknifeReservation(SHOW_ID);

3. Embed a "Book Now" button

<a href="javascript:window.showFireknifeReservation(SHOW_ID);">Book Now</a>

Each show has a unique numeric ID. The venue edit page lists all shows alongside their widget call and a direct link (e.g., https://widget-staging.fire-knife.com/royal-1). Always use the correct ID for each show.

Managing bookings

Viewing and searching

Navigate to Bookings in the sidebar. The list shows Booking ID, Confirmation code, Status, Show, Timeslot, and guest contact details. You can search by name, by Booking ID, or by Confirmation code. Filter by timeslot using the dropdown.

Booking statuses

Booking detail page

Click any booking row to open its detail page. From here you can:

• View and edit Contact information (name, phone, email, language) via the pencil icon.
• View Additional information — guest responses to any custom fields (e.g., hotel, allergies).
• See each Booking item — seat number, ticket option, ticket type, and price per ticket.
• Review the full Orders history — order ID, status, amount, payment type, timestamps, and rollback time.
• Click Refund reservation to issue a partial or full refund.
• Click Cancel reservation to cancel the entire booking.

Creating a booking (Agents)

Agents can create bookings on behalf of guests directly from the admin. Select a show and timeslot, choose ticket type and quantities, fill in the guest's contact information and any required custom field answers, then process payment using any enabled method — including agent-only methods like cash or inhouse.

Catering view

Navigate to Catering view in the sidebar. Select a show from the dropdown, navigate to a date on the calendar, and click Continue to view a catering manifest for that timeslot. This gives the catering team a structured view of guests, party sizes, dietary notes, and custom field responses for food and beverage preparation.

Check-in view

Navigate to Check-in view in the sidebar. Select a show and date, then click Continue to open the check-in interface for that timeslot. This view is optimized for front-of-house staff marking guests as arrived, scanning tickets, or verifying bookings at the door.

Manual refunds

Navigate to Manual Refunds to see all refunds processed outside the standard flow. The list shows:

• The show, timeslot, and booker details
• The refund amount, payment type, and any refund note
• Who processed the refund and when it was marked as finished

Use the Only unfinished filter to surface any pending refund requests that still need to be processed.

Waitlist

Navigate to Waitlist to manage guests who signed up when a timeslot was fully booked. Filter by show and timeslot. Each entry shows:

• Subscriber details — name, email, phone
• Requested — ticket quantities (e.g., "10x Premium Adult, 10x Premium Child")
• Fulfillability — whether enough seats are now available
• Activity — whether the subscriber has been notified

Click Reminder on an individual entry to send a notification, or use Send Bulk Reminder to notify all eligible subscribers at once.

Reports

Navigate to Reports and configure the filter panel on the left, then click Apply.

Click the download icon next to Apply to export the report to a file.

Invoices

Navigate to Invoices to generate affiliate commission invoices for external partners. Select a venue, show, commission group, and date range, then click Generate Invoice. Previously generated invoices appear in the Invoice History section and can be re-downloaded at any time.

Integrations

Each show can connect independently to third-party platforms. From a show's ⋮ menu, select Integrations.

Each integration is toggled on or off independently per show. A disabled badge appears when the integration is inactive.

Audit logs

Navigate to Audit logs to see a complete timestamped record of every action taken in the platform. Each log entry shows:

• The venue where the action occurred
• The user who performed it
• The log type (e.g., login, edit_show, add_booking, edit_commission_group, add_timeslot)
• A short description of what changed

Click any row to expand it and see the full log data. Audit logs are read-only and cannot be modified.

Email logs

Navigate to Email logs to see all system emails sent from the platform. Each entry shows the recipient address, subject line, send result (success/failure), type (email or SMS), and timestamp. Use the search box to find emails for a specific guest or booking.

Common email types include:

• Your reservation has been confirmed — sent on successful booking completion
• Payment Required — sent for bookings awaiting payment
• iCal Sync – Timeslots Updated — sent to relevant users when a calendar sync updates availability
• Affiliate invoice — sent to commission group contacts when an invoice is generated
• How was your experience? — post-visit review request email

Role reference

A summary of which features are accessible to each user role.