Restrict Capacity
  • 15 Dec 2023
  • 1 Minute to read
  • Dark
    Light

Restrict Capacity

  • Dark
    Light

Article Summary

Capacity can be set on either the Event or Event Item (Ticket).

Important Total Capacity Setting

To prevent incorrect Total Capacity totals on the Event record, the Total Capacity for the Event will be controlled from the Event Item record. Moving forward, the Total Capacity field on the Event record will automatically be set to “Read Only” during installation.

Ticket Capacity Rolls up to the Event

The Event's Total Capacity is the sum of Quantity Available on all Event Items (Tickets).

The Blackthorn API, by design, does NOT run capacity validations. Users must add their own logic to implement capacity restrictions.

The API intentionally does not trigger the validation on capacity to allow for flexibility for all customers. When sending registrations through the API, customers can utilize their own custom logic to prevent registrations when the capacity is sold out.

The Status Formula field is on the Event Item object. If the Quantity Remaining is "0", then the Status Formula field will show Sold Out. The custom code can evaluate the formula to block the registration once the Quantity Remaining is zero.

For an incoming payload:

  • 0 is treated as a sold-out.
  • Null or empty Events are treated as infinite, and Total Capacity is automatically set to “999999”.

Restrict Capacity per Event Item (Ticket)

When an Event’s Remaining Capacity = “0”, then the Event is sold out. If the Total Capacity field is left blank, then the Total Capacity is set to infinity. On the Event record, the Total Capacity field will be “999999”.

When Event Item's Quantity Remaining = “0”, then the Event Item is sold out. If the Quantity Available field is left blank, then the Quantity Available is set to infinity. On the Event Item record, the Quantity Available field will be “999999”.

  1. Edit your Event Item (Ticket).
  2. Navigate to the Quantity Available field and enter the amount.
  3. Click Save.

This also rolls up to the Event Record as Total Capacity.
restrict capacity per ticket