How to Create Polls

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 :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=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:

  1. option one
  2. option two
  3. 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.

2 Likes