Both administrators and users can create polls, perform actions like edit, copy, delete and so on. Administrators can see all the available polls but users can see only those polls that they created or the ones shared with them. On the same note, regardless of user type, only those users can vote for polls that were shared with them.
To vote for a poll, you must first add a Polls macro to your page. Unless this poll has been shared, users cannot vote in the poll.
The basic concepts about polls and voting are mentioned in the sections below. Click the required link to know more:
Polls macro
Sharing and voting
Notifications
Poll status
Perform actions on polls
Create polls
Polls macro
To vote for a poll, users must add a Polls macro to the required page. Specify the poll to be voted, provide a few other settings and publish the page.
The server and cloud versions of the macro are as follows:
Server | Cloud |
---|---|
Macro parameters
The following table describes the parameters available in the macro editor per version:
Parameter name | Labels | Default value | Description |
---|---|---|---|
Poll | SERVER CLOUD | Select the poll you want to display from the list of your polls. In cloud, you can also use the + button to create a new poll without leaving the macro window. | |
Display Name Display Poll Name | SERVER CLOUD | On | |
Display Description | SERVER CLOUD | On | |
Display Author and Date Created | CLOUD | On |
Sharing and voting
Share your poll 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. As long as other users don't have the exact link to your poll, it will only be visible to you.
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.
Notifications
By sharing a poll, users will receive an email and a notification in their workbox with a link to the poll. In return, you as the author of the poll will be notified when a user has voted in one of your polls.
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.
Unregistered voting
Voting for the user who does not have Confluence account can be turned on by enabling Allow unregistered users to vote option on poll settings. Global 'can use' permissions for anonymous users and anonymous access to particular space if poll is embedded on the page/blog post is also needed to allow users to access the poll.
Note: You will not be able to disable Allow unregistered users to vote options once it's enabled and poll is saved.
Polls macro
Use the Polls macro to embed your polls on wiki pages or blog posts.
Parameters
Parameter name | Default value | Description |
---|---|---|
Poll | - | Choose the poll you want to display from the list of your polls. Polls are referenced by their guid. |
Show Name | true | Disable to hide the name of the poll. |
Show Description | true | Disable to hide the description of the poll. |