Skip to main content

Tickets

Quick Links

Overview · Interface Preview · Quick Start · Modes of Sale · Create & Manage · Display Settings · Public Flows · Share Link · Permissions · Best Practices · Troubleshooting · FAQ · Videos

Screenshots & Videos

Place real assets under /images and /videos using root paths.

📌 Why Tickets?

Your access model and revenue plan in one place—inventory, price strategy, and public display that align with forms and tags.

Tickets define purchasable or assignable access types for an event (e.g., General Admission, VIP, Staff Pass). They control pricing, capacity, access zones, and registration form requirements.

Overview​

  • Define ticket types, set prices, and configure purchase behavior
  • Manage public display and inventory
  • Support single-ticket and multi-ticket purchase flows
  • Preview customer-facing ticket pages

Interface Preview​

Tickets List Create Ticket Display Settings Public Ticket Card Public Multiple Tickets

Quick Start (Admin)​

  1. Go to Event > Tickets
  2. Click Create New Ticket
  3. Fill in:
    • Name (required)
    • Description (optional)
    • Price and Initial Price (optional; struck-through if > Price)
    • Quantity (capacity)
    • Sale window (Start/Stop Selling)
    • Status: Active toggle
    • Tag: choose exactly one
  4. Save
  5. Optional: configure Display Settings and preview
  6. Share the public ticket link

Modes of Sale​

  • Multiple Tickets Mode: catalog view, Add to Cart, quantity controls, cart modal, checkout with contact info
  • Single Ticket Mode: guided 3-step flow (Ticket Selection → Registration Form → Checkout)
  • Toggle controlled via event setting multiple_ticket_purchase

Admin: Create and Manage Tickets​

Ticket List​

Navigation: Event > Tickets (scoped to current event)

Ticket List

Create Ticket​

  • Click Add Ticket
  • Fill fields as described in Quick Start
  • Optional: Advanced display and styling via Display Settings

Ticket Create Form

Edit / Delete​

  • Edit: pencil icon in Actions
  • Delete: trash icon (soft-delete; confirmation required)

Inventory & Availability​

  • A ticket is visible publicly if:
    • is_active = true
    • Current time is within sale window
    • Remaining stock > 0
  • Remaining = quantity - (sold + pending_cart + pending_transaction)

Admin: Public Display Settings​

Customize appearance of public ticket pages:

Ticket Display Settings

  • Content: header_content, footer_content (TinyMCE editor)
  • Colors: primary, secondary, background
  • Card design: hover transform, spacing, shadow
  • Typography: ticket name, sale date font/color
  • Preview: opens public listing with ?preview=1 applying unsaved overrides

Public Purchase Flows​

Multiple Tickets (Catalog + Cart)​

  • Add tickets to cart; adjust quantity
  • Checkout collects:
    • First Name, Last Name, Email, Phone
    • reCAPTCHA v3 validation
  • Payment redirect or free ticket instant success
  • Quantity is held during checkout

Single Ticket (3-Step Guided)​

  1. Choose ticket card (available only)
  2. Registration Form (from Tag’s public Form.io form)
  3. Checkout:
    • reCAPTCHA v3 validation
    • Payment or auto-success for free tickets

Public Ticket Pages​

Mode depends on multiple_ticket_purchase setting

Public Tickets Multiple Public Tickets Single

Behavior:

  • Only active tickets in sale window appear
  • Sold-out tickets displayed as Sold Out or hidden
  • Initial Price shows struck-through if > current Price
  • Admin Preview applies temporary style overrides
  • Copy from Tickets page using Copy Public Link

Permissions​

ActionPermission
View Ticketsticket.viewAny
Create Ticketticket.create
Edit Ticketticket.edit
Delete Ticketticket.delete
Display Settings Viewticket-style.viewAny
Display Settings Editticket-style.edit

Best Practices​

  • Align sale windows with marketing campaigns
  • Use Initial Price to show discounts clearly
  • Avoid too-low quantities; rely on pending hold logic
  • Preview Display Settings before saving visual changes

Troubleshooting​

IssueFix
Ticket not visible publiclyEnsure Active, within sale window, remaining stock > 0
“Requested quantity not available”Inventory low or pending holds exist; try smaller quantity or later
Checkout reCAPTCHA failureRetry; ensure network allows Google; contact support if persistent
Styling not updatingSave Display Settings; Preview is temporary
Wrong currency on public pageCheck Event Settings → currency

FAQ​

  • Show multiple ticket types on one page? Enable multiple_ticket_purchase and create separate tickets
  • Free tickets? Price 0 auto-completes in single-ticket flow; multi-ticket requires payment redirect if amount > 0
  • Forms tied to tickets? Each ticket linked to one Tag; Tag may have a public registration form
  • Preview public page without going live? Use Preview in Display Settings; temporary styling only

User Story & Walkthrough Videos​

Single Ticket Purchase Flow​

Single ticket purchase: streamlined flow for events selling only one ticket type.

Direct Download: Download the MP4

Multiple Tickets Purchase Flow​

Multiple ticket selection: choosing quantities across several ticket types before checkout.

Direct Download: Download the MP4

Last updated: 2025-10-09