How to Create Polls


(Joshua Rosenfeld) #1

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

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,50%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* ![image|690x334,50%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* ![image|690x499,50%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]
[poll type=regular]
* Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
![image|690x458,50%](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.
![image|690x334,50%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
![image|690x499,50%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]

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]

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


(Joshua Rosenfeld) #8

2 posts were split to a new topic: Automatically close a poll on a given date/time?


(Peter Toby) #9

Is it possible to create a multiple question poll in a topic and make it mandatory to respond to each question?


(Fellowship Forums) #10

The poll that you have above, numbered from 1-10 goes on to two lines. 8, 9, and 10 are on the second line. How do you make all the values only appear on one line?


(cpradio) #11

It is wrapping due to space constraints… it can’t fit on a single line.


(Fellowship Forums) #12

Is there a way to make the text or spacing smaller?


Number Rating Poll - Show on One Line
(cpradio) #13

Probably, using CSS.


(Aryeh Jacobsohn) #14

Love the polls!

As a poll-creator, is it possible for me to download the raw data from a poll?

For example, I posted a poll to Pivotal’s internal forum to which people can respond with a number one through twenty. I can see the average response, but am more interested in the raw responses in order to produce a histogram, examine the range, etc.


(Joshua Rosenfeld) #15

Not currently, no. Discourse polls are intentionally “simple”, and are not meant to be used for data analysis like that. An admin could likely query the data via the Data explorer plugin, but an end user cannot.

To obtain data like this, we recommend using a full featured poll system, not Discourse polls.


(Jeff Atwood) #16

Can we put together a Data Explorer example query for this?


(Joshua Rosenfeld) #17

Sure, adding to my list.


(Joshua Rosenfeld) #18

Looks like @gerhard already wrote one, and it still works. See Is it possible to see who voted in polls?. Note that you’ll need the post_id of the post that contains the poll. To obtain the post_id you’ll need to look at the json of the topic. Append .json to the end of the URL. For example, the post_id of this post can be found at https://meta.discourse.org/t/how-to-create-polls/77548.json (and is 424951). The post_id of the first post in this topic is 368654.


(Veermanhas) #25

Is there a way to allow visitors vote without logging in?


(Joshua Rosenfeld) #26

No there is not. To prevent duplicate entries accounts are required. If you need anonymous polls I’d suggest an external service like https://www.strawpoll.me/