Listing Options
How options model the divisions, brackets, or sessions a registrant can sign up for within a listing.
A listing option is a single thing a registrant can sign up for inside a listing — typically a division (e.g., "Mixed 4.0"), a session slot, or a paid tier.
A listing has one or more options. Registrations are always per option, not per listing.
Option metadata
Each option carries structured metadata used to render rich option cards on the public landing and to gate eligibility:
- Team type and gender type (rendered as colored badges)
- Age and skill-level requirements
- Format (e.g., round-robin, single elimination)
- Prizes
- Price — pricing is USD-only today; the currency is fixed at
usd - Capacity and current registration count
- Registration status — see below
Registration status
Every option has a registration_status that controls whether new registrations
can be created:
| Status | Meaning |
|---|---|
| inherit (default) | Falls back to the parent listing's status |
| Planned | Option exists but registration isn't open |
| Open | Registrants can sign up |
| Closed | Registration is closed for this option only |
Setting an option to Closed while the listing is Open is the supported way to take a single division offline (e.g., when it sells out) without affecting the rest of the listing.
The public Register action and the staff badges always reflect the effective status — the option's override if set, otherwise the listing's status.
Free vs paid options
- Free options support one-click registration directly from the option card.
- Paid options route through
/l/<org>/<event>/registerfor checkout. Payment is collected through Stripe — see Payments and Stripe.
Managing options
Staff manage options from the listing's Options tab at
https://register.paddlesup.io/listings/<id>. Option detail fields support inline
edit with autosave / cancel / save controls.
See Managing listing options for the step-by-step.