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 name="poll_multiple1" type=multiple]
- option one
- option two
- option three
[/poll]
This creates the following result:
- option one
- option two
- option three
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]
* ![image|690x458,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* ![image|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* ![image|690x499, 50%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]
Polls can include relative dates!
[poll " type=regular]
* [date=2019-10-13 timezone="Europe/Paris"]
* [date=2019-10-12 timezone="Europe/Paris"]
* [date=2019-10-11 timezone="Europe/Paris"]
[/poll]
- 2020-10-12T22:00:00Z
- 2020-10-11T22:00:00Z
- 2020-10-10T22:00:00Z
0 voters
For a numbered poll, enter the following:
[poll name="poll_number1" 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]
Lastly, any poll can have the voters made “public” by adding public=true
to the parameter list.
[poll public=true]
- Yes
- No
- Maybe
[/poll]