The guide · Section 2 of 15

Build a poll

Create poll, the poll's one screen — the title, the statement, the question, its choices and their attachments — the rules, the closing date, the vote limit, event mode, and opening it.

The poll's screen

On Your polls, press Create poll.

The poll's own screen opens at once. It says Edit poll at the top, and the poll is a draft from that moment: Draft shows under the title. Everything about the poll is on this one screen, from top to bottom:

  1. Title — the line voters read at the top of the poll.

  2. Statement (optional) — text voters read before the question: an introduction, an instruction, a note. It takes no answer, and it shows on the voting page and the results page. Press Add statement to add one.

  3. Question — what people vote on, and how they vote:

    • Single choice — voters pick one
    • Multiple choice — voters can pick more than one
    • Ranked — voters put the choices in order

    Attach, on the question's row, adds one picture or PDF, shown at the top of the poll.

  4. Choices — press Add choice for each one, or Bulk add to paste a list, one per line. Each choice's row has its own Attach, for a picture of that choice; the ✕ beside the choice deletes the choice. Once something is attached, its row shows it with Replace and Remove. The vote is always for the choice, never the picture. Tick Allow an “Other” free-text choice if people may write in their own answer. Preview (what a voter answers) shows the question the way a voter will see it.

  5. About your voters — optional questions about the voters themselves. See Questions about your voters.

  6. Who can vote — Anyone with the link, or Only people on a member list. See Who can vote.

  7. Rules, Afterward, Share this poll, Locations and Poll ideas — below.

  8. More settings — the poll's folder and its clock.

A new draft, just made with Create poll.
A new draft, just made with Create poll.

Press Save at the bottom, or the same button pinned at the top of the screen. One press saves everything on the screen. The page says Saved. beside the button. The poll is on Your polls, under Drafts, by its title.

A few things save the moment you change them: the switches in Rules, an attachment, a location. The things with a button of their own — Save times, Save webhook, a location's Save tags — work on their own too, and Save saves them as well.

If you leave the screen with changes you haven't saved, the browser asks Leave without saving? A new draft you leave with nothing in it is thrown away on its own, so it never sits on Drafts.

A poll has one question. If you need two questions, make two polls.

A button that can't do anything yet is greyed, with one line under it saying when it wakes. On a draft, Delete stands where Cancel poll stands: a draft is deleted, not cancelled.

On a poll that is… Greyed until…
a draft Full results, Copy results link, Download votes (CSV) and Raw data: the poll is open. Open now: the poll has a title, a question and two choices. Create a scrutineer link: the poll is open. Results poster: the poll closes.
open Results poster: the poll closes.
closed or cancelled Nothing.
The question and its choices, each with Attach on its row.
The question and its choices, each with Attach on its row.

To come back to a poll, open it from Your polls. While it's a draft, you can change anything on it.

The rules

The Rules section sets how the poll runs.

The Rules section of a draft.
The Rules section of a draft.

Exit polls

Turn on Exit poll style, the vote can’t be changed in Rules for a poll where each person votes once and that's final. While it's on, Results while the poll is open is held at Nobody until it closes and greyed: Exit polls keep results sealed until the closing date. So everything above about Nobody until it closes holds for an exit poll too — including that cancelling it deletes its votes unseen.

What changes for your voters:

Once the first vote is counted, the setting is fixed: Locked — a vote has been counted, so this can't change now. In a series, set it on the series: every round carries it.

Afterward

The Afterward section is for when the poll is running and after it closes:

More settings, near the bottom, holds the poll's folder and its Clock format: 12-hour (7:00 PM) or 24-hour (19:00). Every time the poll prints follows it — the voting page, the sign, the invitations, the results and the record, Messages, Raw data and the notification lines. Account default uses the clock chosen in Settings.

Once it's on and saved, two lines under it show it working, in the poll's own time zone: Last message sent (or none yet), and, when grouped, Next message at — the time the next message goes, or none waiting until someone votes.

The notification setting on an open poll, grouped every hour.
The notification setting on an open poll, grouped every hour.

Send the result somewhere when the poll closes

This is for a website or tool of your own that should get the result by itself the moment the poll closes: a club site, a spreadsheet tool, a chat channel. Most organizers leave it empty, and then nothing is sent.

In Afterward, under Send the result somewhere when the poll closes (optional), paste the address your tool gave you into Webhook address. It starts with https:// and is 255 characters at most. In Signing secret, type a password of your own that your tool also knows. Press Save webhook. The secret is never shown again, on any screen; the box then says one is set — type to replace it. You can change both until the poll closes.

What is sent, and when. When the poll closes, RollPoll sends one message to that address, within a minute. A poll closes at its closing time or on reaching its vote limit, except a poll set to Nobody until it closes: reaching the limit ends its voting, and it closes at its closing time. A cancelled poll sends nothing: it has no result. The message is a web request (a POST) carrying, as JSON:

If the address doesn't answer, RollPoll tries again 15 seconds later, then a minute after that: three tries in all, then it stops. Your poll closes on time either way, and its results are always at the links on its screen. A try counts as failed when the address takes more than 10 seconds to answer, even if it got the message, so a slow tool can get the same message up to three times: each copy has the same poll_id and record_code, so your tool can keep the first and ignore the rest.

How it's signed. With every message comes a line X-Poll-Signature, reading sha256= and then 64 letters and numbers. They are made from the message's exact words and your secret (HMAC-SHA256). Only someone who knows the secret can make them, so your tool can tell the message came from RollPoll and wasn't changed on the way.

How your tool checks it, in three steps:

  1. Take the message's body exactly as it arrived, before reading it as JSON.
  2. Work out HMAC-SHA256 of that body with your secret, written as hex.
  3. Put sha256= in front. If it matches the X-Poll-Signature line exactly, the message is real. If not, ignore it.

A worked example. A poll set with the secret club-secret-2026 closes with 38 votes, and this body arrives:

{"event":"poll.closed","poll_id":4021,"title":"Club night","counted":38,"checksum":"5f2c9a41d07e8b3366e0f9a2c4d1b7e85a90c3f6d2e14b7a8c5d6e9f0a1b2c3d","record_code":"5f2c9a41d07e","final_url":"https://rollpoll.ca/r/k3v9qx2m/final","manifest_url":"https://rollpoll.ca/r/k3v9qx2m/manifest.json","csv_url":"https://rollpoll.ca/r/k3v9qx2m/data.csv","poster_url":"https://rollpoll.ca/r/k3v9qx2m/poster"}

with X-Poll-Signature: sha256=8126b58a3df69753b0e996c69bb244a343bf201fca4658e2927a3f65526dbf74. On a Mac, save the body in a file named body.json and type in Terminal:

openssl dgst -sha256 -hmac 'club-secret-2026' < body.json

It prints 8126b58a3df69753b0e996c69bb244a343bf201fca4658e2927a3f65526dbf74: the same, so this message is real. In PHP, a website checks it with:

$body = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $body, 'club-secret-2026');
$real = hash_equals($expected, $_SERVER['HTTP_X_POLL_SIGNATURE'] ?? '');

After the poll closes, its screen says what happened, under Afterward: Sent to the address at the time it got through, in the poll's own time zone; or Couldn't reach the address after 3 tries, with why the last try failed (the address answered with an error, didn't answer within 10 seconds, or nothing answered there). While the tries are still going it says Sending to the address; reload the page to see how it went. On a cancelled poll it says nothing was sent.

Open the poll

When the poll is ready, go to the bottom of its screen and press Open now. It saves anything you haven't saved first. A box asks Open this poll now?. Press Open now in the box. The poll is now open, and people can vote.

The bottom of a draft's screen.
The bottom of a draft's screen.

Or leave it closed and set Opens: it opens by itself at that time.

Once the first vote is verified, the poll's wording, its choices and its closing date lock and can't be changed. That is what lets anyone check the count.

Ending a poll

A poll closes by itself at its closing date, or when it reaches its vote limit. On a poll set to Nobody until it closes, reaching the limit ends the voting, and the poll closes at its closing date. The only way to end it early is Cancel poll. A box asks Cancel this poll?. Press Cancel poll to cancel it, or Keep the poll open to leave it running. A cancelled poll shows as VOIDED, with no winner and no result. It can't be undone. On a poll set to Nobody until it closes, the box also says Its votes will be deleted unseen — nobody, you included, will ever see them. — and they are: the votes, the answers about voters and the record's entries are deleted the moment you press Cancel poll. You're still charged for the votes cast, as on any cancel.

Change a poll that's open

Once a vote is counted, the title, the question, the choices, the closing date and the vote limit are fixed. The screen says Locked — a vote has been counted beside each one.

If a choice should not be on the poll, press Withdraw beside it. It stays on the poll page, greyed and marked withdrawn, and nobody new can vote for it. The votes already cast for it still count. Put back undoes it.

Still stuck? Signed in, use Contact RollPoll. Not signed in, Contact us.