Skip to main content
Percy’s poll system lets you post rich, timed votes directly in any channel. You define the question, up to 8 answer options, a deadline, and optional extras like a discussion thread or a ping notification. When time runs out, the poll closes automatically and the results are locked in.

​
How Polls Work

When you create a poll, Percy posts an interactive card in your chosen channel. Members click a button or select an option to cast their vote. Each member can vote once, and you can optionally require them to provide a written reason. The poll closes at the time you specify — or earlier if you end it manually. A discussion thread can be opened alongside the poll so voters can talk without cluttering the main channel.

​
Commands

/polls create, /polls end, /polls delete, /polls edit, /polls debug, and /polls config require Ban Members or Manage Messages.

​
Creation Flags

Pass these flags when running /polls create to customize your poll:

​
Example

This creates a 24-hour poll with three choices. Members click one of the option buttons to cast their vote.

​
Creating a Poll Step by Step

1

Configure a poll channel

Run /polls config --channel #polls so Percy knows where to post polls by default. You can skip this and always pass --channel at creation time instead.
2

Create the poll

Run /polls create with a duration, your question, and at least two options. Percy immediately posts the interactive card and schedules the timer.
3

Let it run

Members vote by clicking the buttons on the poll card. You can monitor results in real time using /polls search or by looking at the live vote counts on the card.
4

End or wait

The poll closes automatically when the timer expires. You can also run /polls end <poll_id> to close it early. Once ended, the card updates to show final results and voting is disabled.

​
Editing a Running Poll

Use /polls edit <poll_id> with any combination of the edit flags (--question, --description, --color, --image, --image_url, --thread_question, --opt_1 through --opt_8) to update a live poll without restarting it. Pass --clear as the value for any field to remove it entirely. For example, --description --clear strips the description from the card. When using the slash command version of /polls edit, Percy opens a modal form pre-filled with the current values so you can edit inline.

​
Searching Polls

/polls search accepts several flags to filter and sort:
Use /polls config to set a default channel, a reason channel (for --with_reason votes), and a ping role. Without a default channel configured, you must pass --channel every time you create a poll. Pass --reset to wipe all poll configuration back to defaults in one step.
Add --thread_question "Share your thoughts below!" to automatically open a discussion thread on every poll. The thread archives and locks itself when the poll ends.