Skip to content

Polls

Gather attendee input with single-choice, multiple-choice, and availability polls.

Quick outcome

Polls let organizers collect decisions from attendees — meal preferences, activity choices, availability for optional events, and more. Attendees vote on the public site; organizers create and monitor polls from the admin dashboard.

Setup

No special configuration needed. Polls are available by default and require attendees to be signed in to vote.

Day-to-day management

Creating a poll

Navigate to /admin/polls/new:

FieldDescription
TitlePoll question or topic
DescriptionAdditional context or instructions
Typesingle (one choice), multiple (multiple choices), or availability
AnonymousIf true, voter identities are hidden from results
Allow otherIf true, voters can write in a custom option
OptionsList of choices voters can select

Poll types

TypeBehavior
singleVoters select exactly one option
multipleVoters select one or more options
availabilityVoters mark availability for each option (commonly used for date/time selection)

Managing polls

From /admin/polls:

  • View all polls with status and vote counts
  • Click to edit at /admin/polls/[id]
  • Open or close polls (closed polls accept no new votes)
  • View detailed results with voter breakdowns (unless anonymous)
  • Reorder polls by sort order

Poll lifecycle

StatusBehavior
openAccepting votes
closedNo new votes; results frozen

Closing a poll is permanent from the voter's perspective — they can no longer change their response. Organizers can reopen a poll by changing its status back to open.

Attendee experience

Viewing polls

Attendees visit /polls (requires sign-in) to see all published polls:

  • Open polls show the question, options, and a voting form
  • Closed polls show results only

Voting

At /polls/[id]:

  1. Read the poll question and description
  2. Select option(s) based on poll type
  3. Optionally enter write-in text (if "allow other" is enabled)
  4. Submit vote

Voters can update their response while the poll is open (depending on poll configuration).

Results

After voting, attendees see:

  • Their own selection highlighted
  • Overall vote distribution (bar chart or count)
  • Other voters' choices (unless the poll is anonymous)

Troubleshooting

SymptomFix
Poll not visible to attendeesVerify it's published and the attendee is signed in
Cannot submit voteCheck poll status (must be open) and option selection
Response changed unexpectedlyVerify whether the poll allows vote updates
Invalid option setEnsure at least two valid options exist
Anonymous results showing namesVerify the anonymous flag is set
Cannot edit closed pollReopen the poll to allow edits

Next steps

Released under the MIT License.