Files
TREK/wiki/Collab-Polls.md
T
jubnl 77dddd5e8a v4.0.0 (#1719)
Release branch for 4.0.0.
2026-08-27 13:22:39 +02:00

3.1 KiB

Collab Polls

Create group polls to make decisions collaboratively — where to eat, which hotel, what to do on a free day.

A trip poll with three options and the current vote counts

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.

Real-Time-Collaboration · Collab-Chat · Collab-Notes