Skip to main content
The step-by-step guide to creating a poll in Confluence
Share on socials

The step-by-step guide to creating a poll in Confluence

A headshot of Matt Christiansen
Matt Christiansen
1st February, 2024
A colourful graph with different user icons to represent a poll
A headshot of Matt Christiansen
Matt Christiansen
1st February, 2024
jump to section
When to use polls in Confluence
How to create a poll in Confluence
How to customise your Confluence poll

Ready to engage team members and users alike? Learn how to create a poll in Confluence, and when to use them.

Polls are a simple but effective tool for getting familiar with the thoughts of team members and customers alike, allowing you to steer decisions in the right direction.

Looking to gather richer insights than the quick look a poll can provide? Read our guide to learn how to create forms and surveys in Confluence.

When to use polls in Confluence

Polls are fantastic for gathering opinions quickly and conveniently and letting users feel heard. You might use polls to:
  • Vote on the theme of the next company event,
  • Decide on a topic for a training session,
  • Gauge employee availability on certain dates,
  • Measure interest in a potential new product or service,
  • Pick a book for an internal book club,
  • Battle it out between the two most popular logo design choices,
  • And more!
You can also see an instant visualisation of poll results as responses come in.

How to create a poll in Confluence

Confluence doesn’t come with a built-in poll macro, so you’ll need the help of an app.
1. Install Forms for Confluence (free for up to 30 days).
2. Go to the page you want to create a poll on. Type the shortcut /poll and click the Create poll macro.
The Forms for Confluence poll shortcut typed on a page
3. Enter a title and description for your poll in the assigned boxes. Select any users or groups you'd like to have as collaborators. Then click “Continue”.
The Forms for Confluence poll configuration dialog with a title and description tailored for a book club
The poll will automatically be assigned to the Space and Parent page you created it in.
4. Choose your poll question type, add your poll options, and choose a title.
The Forms for Confluence poll editor dialog showing different options for a book club
5. Click "Save" to save your poll. Then select "Publish" or "Update" in the top-right corner of your page to publish your new poll.
A published Forms for Confluence poll showing January book club options to vote on

Other ways to create a poll

Again, you’ll need to have Forms for Confluence installed in order to access polls.

Option 1:
You can also get started with creating a poll from any page - not just the specific page you want the poll to appear on.
From a page, click the Content Formatting Macros icon from the toolbar. Then, click "Poll". Continue by following step 4 onwards as above.
The Forms for Confluence pop-up showing the option to choose between polls and forms
Option 2: Under the Apps tab, select Forms for Confluence.

Click Create new form. Then, select Poll. Continue by following step 4 onwards under the ‘How to create a poll in Confluence’ section earlier in this guide.

How to customise your Confluence poll


1. In the poll builder, choose a poll type (how respondents can answer). You can choose from checkboxes, a star rating, radio group, radio button matrix, or checkbox matrix.
2. Type in a title for your poll.
3. Add responses for users to choose from by typing in the box under Options. Add more response options by clicking Add option.
Image showing a poll in the Confluence poll editor dialog
4. Customise your poll by selecting the Appearance options. You can choose to display the poll name, or have a border around the poll.
GIF of a user toggling to show the poll name at the top of the Confluence poll editor
So now you know how to create a poll in Confluence and customise it to suit you. Time to get the votes rolling in!
Gather opinions quickly and simply with a 30-day free trial of Forms for Confluence.
Written by
A headshot of Matt Christiansen
Matt Christiansen
Product Marketing Manager
With more than a decade of expertise in digital and product marketing, Matt serves as the Product Marketing Manager for Forms for Confluence at Kolekti. His passion lies in helping teams to effortlessly collect and comprehend user feedback within the Confluence platform.

LinkedIn →
Confluence
Forms