Skip to content

Custom Fields

Extend the RSVP form with event-specific questions.

Quick outcome

Custom fields let you add your own questions to the RSVP form — t-shirt sizes, arrival times, dietary preferences beyond the built-in field, or any event-specific data. Fields can apply to the entire RSVP or to each individual attendee.

Setup

Creating a field

Navigate to /admin/custom-fields/new:

FieldDescription
LabelDisplay text (e.g., "T-Shirt Size")
Field keyStorage key (auto-generated or manual, e.g., tshirt_size)
TypeInput type (see below)
Scopersvp (one answer per party) or attendee (one per person)
RequiredWhether the field must be filled
PlaceholderHint text inside the input
Help textDescription shown below the field
Sort orderDisplay position in the form

Field types

TypeRenders asExample use
textSingle-line text inputArrival flight number
textareaMulti-line text areaSpecial requests
selectDropdownT-shirt size (S/M/L/XL)
multiselectMulti-select dropdownInterested activities
checkboxSingle checkbox"I agree to the waiver"
numberNumeric inputNumber of parking spots needed

Adding options

For select and multiselect types, add options:

FieldDescription
ValueStorage value (e.g., small)
LabelDisplay text (e.g., "Small")
Sort orderOption display order

Scope

ScopeBehaviorExample
rsvpOne answer per RSVP submission"How did you hear about the event?"
attendeeOne answer per person in the party"T-shirt size"

An attendee-scoped field appears once for each attendee added to the RSVP. An rsvp-scoped field appears once for the whole submission.

Day-to-day management

Reordering fields

From /admin/custom-fields, drag to reorder. The sort order controls where fields appear in the RSVP form relative to the built-in fields.

Editing fields

Click a field to edit its label, type, required status, and options. Changes apply to new RSVP submissions. Existing RSVPs retain their stored values.

WARNING

Changing a field's key or type after RSVPs have been submitted may cause inconsistencies in stored data. Prefer adding new fields over modifying existing ones.

Viewing responses

Custom field values are stored as JSON in the RSVP/attendee records. View responses:

  • In individual RSVP detail pages at /admin/rsvps/[id]
  • In RSVP exports (custom field values included)

Attendee experience

Custom fields appear in the RSVP form:

  • rsvp-scoped fields appear in the main form section
  • attendee-scoped fields appear within each attendee's section
  • Required fields must be completed before submission
  • Placeholder text and help text guide the attendee
  • Select/multiselect fields show configured options in a dropdown

When editing an existing RSVP, previously entered custom field values are pre-populated.

Troubleshooting

SymptomFix
Field not showing in RSVP formCheck scope setting and verify the field isn't hidden by sort order
Validation error on submitEnsure required fields have values and option formats are correct
Select field has no optionsAdd options for select and multiselect types
Data inconsistent after field editExisting RSVPs keep old values — consider adding a new field instead
Export missing custom dataCustom fields are included as JSON — check your export format

Next steps

  • RSVPs — see how custom fields appear in the RSVP flow
  • People & Access — manage who can submit RSVPs

Released under the MIT License.