Paddles Up Docs
Guides

Managing Listing Options

How to add, edit, delete, and gate options on a registration listing.

This guide is for organization staff. See Listing options for the underlying model.

Adding a new option

  1. Open the listing at https://register.paddlesup.io/listings/<id> and switch to the Options tab.
  2. Tap New option. A dialog opens.
  3. Fill in:
    • Name (e.g., "Mixed 4.0")
    • Team type and gender type (rendered as colored badges)
    • Age and skill-level requirements (optional)
    • Format (e.g., round-robin, single elim) and prizes (optional)
    • Price — pricing is USD only today; the currency input has been removed and is fixed at usd. Leave the price empty for free options.
    • Capacity
  4. Save.

Editing option details

Open the option detail view from the Options tab. Most fields support inline edit with autosave / cancel / save controls — click a field, edit, then save or cancel. Markdown fields (description, prizes) save the same way.

Deleting an option

From the Options tab, use the per-row Delete action and confirm.

Options with active registrations cannot be deleted. The action returns a 412 Precondition Failed and surfaces a clear toast. Cancel or refund the outstanding registrations on that option first, then retry.

Setting an option to open or closed

Each option has a registration_status that overrides the listing's status:

SettingBehavior
Inherit (default)Use the listing's status
PlannedOption is visible but registration is not open
OpenRegistrants can sign up for this option
ClosedBlock new registrations for this option only

The public Register action and the staff option badges always reflect the effective status — the option's override if set, otherwise the listing's.

Use Closed to take a single division offline (e.g., when it sells out) without affecting the rest of the listing.

Free vs paid options

  • Free options support one-click registration directly from the option card on the public landing.
  • Paid options route through /l/<org>/<event>/register for checkout. See Taking payments.

Reviewing registrations on an option

The Options tab shows a count and badge for each option. The listing-level Registrations tab on /listings/<id> shows registrations across the entire listing.

On this page