Release branch for 4.0.0.
3.1 KiB
Collab Polls
Create group polls to make decisions collaboratively — where to eat, which hotel, what to do on a free day.
Where to find it
Open the trip planner → Collab tab → Polls section. The Collab addon must be enabled and the Polls sub-feature must be turned on. See Real-Time-Collaboration.
Creating a poll
Users with collab_edit permission can click + New Poll in the Polls header. A modal opens with the following fields:
| Field | Required | Notes |
|---|---|---|
| Question | Yes | The poll prompt |
| Options | Yes | At least 2 options required; add more with + Add option |
| Multiple choice | No | Toggle on to allow voters to select more than one option |
| Deadline | No | Mobile only; date and time after which voting closes automatically |
Click Create Poll to save and broadcast the poll to all connected members.
Voting
Click an option button to vote. A filled circle and blue highlight indicate your selection. For multiple-choice polls, you can click additional options to select more than one; clicking an already-selected option removes your vote for that option. For single-choice polls, clicking a different option moves your vote to the new selection.
Voter avatars and the numeric percentage are only visible after you have voted or once the poll is closed or expired. The fill bar behind each option is always drawn, in a faint neutral tint until you vote, and the total vote count in the poll header is visible to everyone — so the rough distribution can be read before you cast your vote.
Results
Each option shows:
- A percentage fill bar that expands proportionally to the votes received
- Up to 3 voter avatar chips stacked next to the option
- The percentage of total votes in the right margin
The option with the most votes is highlighted when the poll is closed or expired.
Deadline
Polls may carry an optional deadline. On mobile the new-poll sheet has a Deadline field — a date-and-time picker with a clear button. The desktop create modal does not offer one yet, so on desktop a deadline can only be set through the API or MCP. When a deadline is present, a live countdown badge appears on the poll card, updating every 30 seconds. The badge shows the remaining time in days/hours/minutes format.
When the deadline passes, the poll is automatically treated as closed: voting is disabled and results are displayed to everyone.
Closing a poll manually
Users with collab_edit permission can click the lock icon on an open poll to close it immediately. Once closed, voting is permanently disabled.
Deleting a poll
Users with collab_edit permission can delete a poll using the trash icon. Deletion is permanent and removes the poll for all members.
Active and closed sections
Open polls appear at the top of the list. Closed or expired polls move to a Closed section below the active polls.
