Modules

Polls

A poll is a question with answers members vote on, with buttons or a dropdown. The results can show live, after members vote, when it ends, or only to your staff. A poll can also be a quiz with a right answer, run again by itself, and post a results card with a chart when it ends.

Creating a poll

Open Poll System → Polls on the dashboard and click Create Poll, or start from a template under Poll Templates. The editor shows a preview of the poll as it will look in Discord.

• Question: up to 240 characters, with emojis anywhere, your server's own too. Add a description and an image if you like.
• Answers: at least 2. Each one can be text, an emoji, or both. You can also add members or roles as answers, for things like staff of the month. They show as mentions on the poll.
• Vote with buttons, or a dropdown for long lists. More than 20 answers always use a dropdown.
• One answer or several: let members pick up to a number of answers each.
• Post it now, at a time, or save a draft. A posted poll can still be edited, and the message in Discord updates.

Without Premium a poll can have up to 10 answers. Premium allows 25. Save any poll with Save as template to reuse it later.

Pictures

Each answer can have a picture, like for an art contest. A poll with 2 to 4 pictures shows them side by side in a grid, with each answer's letter or emoji in the corner of its picture. With 1 or 5 to 9 pictures, each one gets its own card with its answer's name. The winning answer's picture goes on the results card.

Who can vote

• Required roles: members need one of them, or all of them. The poll can show which roles are needed.
• Blocked roles and members can't vote. Without Premium: 2 required roles, 2 blocked roles and 5 blocked members.
• Vote weights (Premium): some roles count as more than one vote. A member counts as their highest one.
• Changing votes: members can move or take back their vote, unless you turn it off. Without Premium, changing a vote needs a vote for Sparrow on top.gg first.
• Members who leave lose their votes on open polls. You can turn this off in Poll Settings.

Who sees the results

• Live: everyone sees the bars change as votes come in.
• After they vote: members see the results privately once they've voted, with the Results button.
• After it ends: nobody sees the counts or who's winning until it ends.
• Only poll staff: members never see the counts or the winner, not even after it ends. Staff see them with the Results button, on the dashboard and in the log channel.

This can't change after a poll is posted, so a hidden vote stays hidden. Poll staff can always see the results. Turn on Anonymous and nobody can see who voted for what, not even admins or Sparrow. Only the totals are kept.

When it ends

A poll ends when its time is up, or early once it reaches a number of voters or a number of votes, whichever comes first. Poll staff can also end it any time. When it ends, Sparrow posts a results card under the poll: the winner, every answer's share, how many voted, and a chart picture. Or write your own result message with {winner}, {percent}, {votes}, {voters} and more.

• Ties: the results card gets a Run a tiebreaker button for poll staff. It posts a new poll with only the tied answers.
• Reminder (Premium): a "this poll ends in 1 hour, vote now" reply under the poll, from 10 minutes to a day before it ends. It can ping the poll's roles again.

Quizzes

Turn a poll into a quiz and mark the right answer. The results and the answer stay hidden until it ends. Then the results card shows the answer, how many got it right, and who.

• Question bank: Sparrow has over 600 trivia questions in 10 categories, like Science, Space, Food & Drink, and Movies, Music & Books. In the editor, press Random question to fill in a question and its answers, and press it again for another.
• Your own questions: add them under Poll System → Quiz Questions, with a category, the right answer and up to 5 wrong ones. 10 without Premium, 500 with it. Each one can have a picture, like a flag to name.
• In Discord, /poll quiz posts a quiz with a random question, from one category or your own questions.

For a quick quiz game with a timer, points and a leaderboard, see Trivia. It uses the same questions.

Repeating polls

A poll can post itself again with fresh votes, every day, week or month. Each run gets its own number. A quiz can ask a new question each run, one it hasn't asked yet. Without Premium a poll repeats up to 3 times in all. Premium removes the limit, can stop on a date, and can repeat every 10 to 59 minutes or every few hours, for things like a trivia question every 30 minutes.

Premium can also repeat right after the last one ends, with an optional break of up to 60 minutes. For quiz rounds back to back: set how long each quiz runs, pick A new question, and when one ends and shows its answer, the next one posts.

Managing polls

The Polls page lists every poll with its status, voters and an Open in Discord button. Each poll's page has the results, the voters and what they picked, a CSV download, and buttons to end, reopen, cancel, copy or delete it. Premium adds an Activity tab with votes over time and the busiest hours. If you remove an answer from a live poll, the editor tells you how many votes go with it before you save.

Who can make polls

• Poll Managers: server admins, Sparrow Master Roles, and the Poll Manager Roles and members you pick in Poll Settings. They use the dashboard and every /poll command.
• Poll Support: can use every /poll command in Discord and end any poll, but not the dashboard.
• Everyone: turn on Everyone can create polls to let any member use /poll create, /poll template and /poll quiz, in the channels you choose. Members' polls never ping or pin, and members can end their own.

Logs

Pick a log channel in Poll Settings. Sparrow posts there when a poll is posted, ends, is cancelled or reopened: who started it, the channel, the answers, when it ends, the result, total votes and voters, who ended it and how long it ran. For polls whose results are only for staff, this is where the results go.

Commands

Scheduling, roles, pictures and the look are on the dashboard. See Access & Permissions for how Sparrow's roles work.

Want an overview instead? See the Polls module page → · See every command →