Discourse Guide: Polls

Creating a poll

The easiest way to create a poll is to use the poll builder. The poll builder can be accessed from the :gear: in the topic composer, and allows you to make a poll without needing to know the exact syntax.



Manually creating a poll

To create a poll surround a markdown list with [poll] and[/poll]

[poll]
- option one
- option two
- option three
[/poll]

or

[poll]
* option one
* option two
* option three
[/poll]

or, for numbered options—

[poll]
1. option one
2. option two
3. option three
[/poll]

Any of the above create the following result:

  1. option one
  2. option two
  3. option three

0 voters


You can also make a poll with multiple choices. Simply add type=multiple to the opening tag like so:

[poll type=multiple]
- option one
- option two
- option three
[/poll]

This creates the following result:

  • option one
  • option two
  • option three

0 voters

To limit the number of choices (or set a minimum), add min=X and/or max=Y

[poll type=multiple min=2 max=2]
- option one
- option two
- option three
[/poll]

This creates the following result:

  • option one
  • option two
  • option three
  • option four

0 voters


For a numbered poll, enter the following:

[poll type=number min=1 max=10][/poll]

Which produces:

[poll name=“poll_4” type=number min=1 max=10][/poll]

You can also have it increment the numbers in steps using step=X

[poll type=number min=2 max=10 step=2][/poll]

Which produces:

[poll name=“poll_5” type=number min=2 max=10 step=2][/poll]


If multiple polls are used in a single post (like this one!) be sure to give each poll a unique name, or they will not work. Do this by adding name="poll_name" as a parameter.

[poll name="poll_1"]
1. option one
2. option two
3. option three
[/poll]

[poll name="poll_3" type=multiple min=2 max=3]
- option one
- option two
- option three
- option four
[/poll]

[poll name="poll_5" type=number min=2 max=10 step=2][/poll]

Lastly, any poll can have the voters made “public” by adding public=true to the parameter list.

Do you like polls?

  • Yes
  • No
  • Maybe

0 voters

7 Likes

Now that there’s so many new poll features (at least, I’m assuming they’re new)… these sound great for running a contest on these forums again.

Bring back the writer’s workshop and put a 1 to 5 poll to rate entries or something :wink:

2 Likes

Nope…they’ve been around for quite some time. I made this guide for another Discourse site I admin, figured I’d copy/paste it here.

1 Like