How to Create Polls

Enabling polls

Polls are enabled in Discourse by default. Site admins can disable polls in their community via the poll enabled site setting.

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,25%](upload://2u570X7kQiPJQaJD1Bd8MLDHDNB.jpeg)
* ![image|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* ![image|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/poll]
[poll type=regular]
* Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
![image|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.
![image|690x334,25%](upload://35fmeFw8RMywSxIc4lbCb8UHPaT.jpg)
* Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
![image|690x499,25%](upload://xSDkRwmuj1pNc2QXKzthfXRlwsX.jpg)
[/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/Paris"]
* [date=2019-10-12 timezone="Europe/Paris"]
* [date=2019-10-11 timezone="Europe/Paris"]
[/poll]
  • 2019-10-12T22:00:00Z
  • 2019-10-11T22:00:00Z
  • 2019-10-10T22: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]

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

30 Likes

How to create a poll when I don’t have this option in the dropdown menu. Is it possible that we have this option disabled?

Indeed, the site setting you’re looking for is poll enabled. I checked your site and it is disabled.

If you want to enable it, but not let all users add polls, check out the poll minimum trust level to create site setting as well.

6 Likes

Polls no longer displayed.

After migrating our forum I see that polls are no longer listed in our Options menu when posting. Here are our basic poll settings:
Screen Shot 2020-05-23 at 10.19.07 AM

How do I change alternative time zone displayed?

I’m seeing my time zone + Paris. How would I change Paris (displayed by default) to Germany?

quick fyi on wording

I’ve noticed Polls are confusing in their wording. I changed text settings as follows:
Show Vote to Edit?
Vote Now to Vote
Show results to Results

2 Likes

This is really useful. I was seeking for help in text formatting in another Discourse forum that ended up bringing me here, but I have something to add: Pie charts!


As I’m a TL0 (and I don’t plan to be promoted), I can’t create polls

Pie charts there are ! :smile:
[poll type=regular results=always chartType=pie]
* yes
* no
* maybe
[/poll]

  • yes
  • no
  • maybe

0 voters

4 Likes

I know, it’s because @jomaxro didn’t put it and it’d be a great addition!

1 Like

A post was split to a new topic: Can I move the create poll button so it is first