Enabling polls
This forum supports polls as we consider it an excellent option to have and improves communication.
Creating a poll
The easiest way to create a poll is to use the poll builder. The poll builder can be accessed from the 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:
- option one
- option two
- 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=3]
* option one
* option two
* option three
* option four
[/poll]
This creates the following result:
- option one
- option two
- option three
- option four
0 voters
Polls can even include images! When including images in polls you may wish to adjust the image size to avoid overly large images.
[poll type=regular]
* ![cat|690x458,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* ![dog|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpeg)
* ![fish|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpeg)
[/poll]
Polls can include text and images:
[poll type=regular]
* Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
![cat|690x458,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
![dog|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpeg)
* Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
![fish|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpeg)
[/poll]
- Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
- Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
- Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
0 voters
Polls can include relative dates!
[poll type=regular]
* [date=2019-10-13 timezone="Europe/Zürich"]
* [date=2019-10-12 timezone="Europe/Zürich"]
* [date=2019-10-11 timezone="Europe/Zürich"]
[/poll]
- 2020-10-13T00:00:00Z
- 2020-10-12T00:00:00Z
- 2020-10-11T00:00:00Z
0 voters
For a numbered poll, enter the following:
[poll type=number min=1 max=10]
[/poll]
Which produces:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
0 voters
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:
- 2
- 4
- 6
- 8
- 10
0 voters
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]
Which produces:
- option one
- option two
- option three
0 voters
- option one
- option two
- option three
- option four
0 voters
- 2
- 4
- 6
- 8
- 10
0 voters
Lastly, any poll can have the voters made “public” by adding public=true
to the parameter list.
[poll public=true]
* Yes
* No
* Maybe
[/poll]
Do you like polls?
- Yes
- No
- Maybe
0 voters
Enjoy polls!
Adapted from Discourse: Hot to Create polls.