The Polls plugin lets you create simple polls to make choices or schedule events within Confluence. Use choice polls to make choices like where to go for lunch, how your newest product should be called, or to survey user satisfaction.

Feature Highlights

  • Create simple polls to make choices or schedule events directly within your Confluence.

  • Share your polls with other Confluence users to invite them to participate in your polls.

  • Use the Polls macro to embed your polls on wiki pages like your custom dashboard or even blog posts

How it works

Every user can access his own polls by clicking the "Polls" menu item. The polls overview screen allows you to manage your existing polls or create new ones. Site administrators can also access "Site Polls" menu item in the administration menu to access and manage all polls made by site users.

Choice polls to make choices like where to go for lunch or how your newest product should be called. Specify as many options as you want, but provide at least two options. Users can then vote for one or multiple options (single choice by default). The results are being displayed once a user vote has been placed or when the poll is closed.

Advanced Settings

  • Display names of other voters - Enable to let users see the list of voters.

  • Allow users to change their votes - Enable to let users change their votes once they have voted.

  • Allow users to select multiple options - Enable to users to select multiple options.

  • Allow users to add options - Enable to allow users to add their own options.

Sharing

As long as other users don't have the exact link to your poll, it will only be visible to you. Share your poll URL with other users to invite them to participate in your poll or embed the poll on wiki pages or blog posts by using the Polls macro to make it available for other users.

Note: Every poll is available under its own unique URL, which is only known to users you share the link with. As long as you don't know the exact URL of a poll, there is no way to find out how you can access it. The polls displayed in the polls list are only the ones created by you. There is no way for users to browse or discover polls by other users unless you share the poll with them or embed it on a wiki page which can be accessed by other users. Though when embedding a poll on a wiki page, you can still use page restrictions to limit access to the poll.

Status

Polls can either be open for voting or closed. You can close a poll manually or by setting the end date of the poll. By closing a poll, users are not allowed to vote anymore. It's also possible to reset a poll, remove all existing votes, and start the voting from scratch again.

Note: Users are not allowed to participate in closed polls. When a user does access a closed poll the results are being displayed directly. It's also not possible to undo choices or add options once the poll was closed.

Administrators

Confluence administrators are able to update or delete polls created by other users as well. Also, there is a "Site Polls" page in administration menu, which lists all existing polls in Confluence and lets admins view, edit or delete them if necessary.

Polls Macro

Use the Polls macro to embed your polls on wiki pages or blog posts.

Parameters

Parameter

Default

Description

Poll
poll

-

Choose the poll you want to display from the list of your polls (there's also a "+" button to create a new poll without leaving the macro window)

Display Poll Name
showName

true

Disable to hide the name of the poll.

Display Poll Description


showDescription

true

Disable to hide the description of the poll.

Display Author and Date Created


showMetaDate

true

Disable to hide author and date poll was created