# 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. ![image-20260907-110445.png](https://help.gocapable.com/images/4e17a975-1df1-4578-b6b8-16b2d593a903.webp) ### Which of these features would you use? Polls are not available on published sites. View and vote in Confluence. ### Did you find this document useful? Polls are not available on published sites. View and vote in Confluence. --- ## 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:. | | 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 [Progress barA coloured bar that shows how far along something is, optionally draggable by readers who can e](https://help.gocapable.com/macros/progress-bar.html) [Progress trackerA horizontal row of numbered, optionally linked steps showing where a process has got to.](https://help.gocapable.com/macros/progress-tracker.html) [Progress, status and feedbackThe rest of this family.](https://help.gocapable.com/macros/progress-status-and-feedback.html) --- _These carry state. Keep them true._