Poll
Asks a question on the page and lets signed-in readers vote on it, showing live counts and percentage bars.
Use it to settle a small decision where the page already is - pick a date, choose a name, gauge who is in favour - without sending people to a survey tool. Readers vote in place; counts and percentage bars update as votes come in, and a voter can clear their own answer and vote again. It is deliberately lightweight: no closing date, no results-hiding, no result export, no admin reset. It is also the migration target for Handy Poll, which brings across the question, the options and the single/multi-choice mode but cannot bring across existing vote counts (those live on Stiltsoft's servers).
#See it
Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up.
#Which of these features would you use?
#Did you find this document useful?
#Settings
Setting | Values | What it changes |
|---|---|---|
Question | Free text | The prompt shown above the options. |
Allow multiple choices | On / Off | Off: options render as radio buttons and a voter picks one. On: options render as checkboxes, a voter may pick several, and the line "Select one or more options" appears under the question. On the server, a single-choice vote repl |
Options (each with a "Label") | An ordered list; drag the grip handle to reorder, "Add option" to append, trash icon to delete. Minimum 2 options - the delete control is inert once you are down to two. | The answers a voter chooses between. Each option carries a hidden stable id; the id is what votes are recorded against, and the Label is what readers see. |
Poll ID | A UUID (not shown in the config form) | The identity of the stored results. Everything about the results - who voted, for what - hangs off this one value, under the storage key formatting:poll:<pollId>. |
Handy poll ID | Text (not shown in the config form) | Records the original Handy Poll UUID when a poll was produced by the Handy Poll migrator. Informational only. |
#Related
These carry state. Keep them true.
