Insufficient information for Survey and Vote Macro

I just installed Survey and Vote Macro and when I try to insert a Vote macro, I get the message

"You have to add choices to the vote to start voting (one line, for each choice)" However, the UI for macro config has provision to update title, Headings for title, Changeable votes, show comments, List of voters, List of viewers, etc. I do not see any option to add choices.

When I try to insert a survey macro, I get different message

"You have to add ballots to the survey to start voting (one line, for each vote)"

6 answers

1 accepted

0 votes
Accepted answer

I agree a javascript based ui could probably improve the UI of the macro, but this one worked quite well for the last 8 years now.

The vote macro allows to let you answer a question which you have to enter in the title field during macro configuration. You then have to add choices (each line one choice) on editing the wiki page (macro body)

The survey macro is a collection of vote macros. You can either control each of the vote macros (or herer called also ballots) with inline dashes ("-" characters). Each line within the survey macro is a full grown vote macro in the end.

Feel free to make suggestions on how to improve user experience here.


Hello, can someone show me how a sample survey and vote macro actually looks like in edit and normal mode? Thanks

If you enter the macro like this:

Bildschirmfoto 2014-10-03 um 10.06.17.png

it will be rendered accordingly:

Bildschirmfoto 2014-10-03 um 10.07.46.png


Thank you Frank Stiller :-)

Yes, I missed the part where I have to add choices in the macro body. I really did not find the option to add choices on the macro configuration, at least not intuitively. The ballots for survey need to have inline dashes, is that part (with dashes) documented anywhere? I just figured it out by looking at the small icon next to the add-on. Suggestions

- The UI configuration should provide options to enter choices and/or

- The documentation can have some screen-captures with example.

The macro is otherwise is excellent and is actively being used by many users in our company.

Thank You

Hi John. Thanks for the suggestions. I added two new issues in this plugins issuetracker:

Adding screenshots should be quite straight. Adding a java script based UI will take some more effort and will not be implemented that fast.

For my defence the help was quite more understandable on confluence 3 and older as there was a really good possibility within confluence and wiki markup. Nowadays a fancy UI is expected. We will see if someone will help out on github, at least some users helped already ;).

Hi Frank,


I have use below scripts in page layout but unable to vote my confluence version is (5.5.2), kindly suggest.


##$helper.renderConfluenceMacro("{survey:alwaysShowResults=true | title=Default-survey | viewers=admin | voters=agent | choices = Excellent,Good,Poor}")

$helper.renderConfluenceMacro("{survey: title=Default-Vote | viewers=admin | voters=agent}")

Hi Mayank, the manual still says that there are no questions involved in your configuration: `{survey:changeableVotes=true|voters=user1,user2|viewers=user3} Knowledge - This is the knowledge category. Communication - This is the communication category. {survey}` see the wiki usage guide for old wiki syntax: Why dont you use the new Macro Browser functionality? Wiki Syntax is not recommended by Atlassian since quite some time and the survey plugin supports it quite nicely also a while

The title on a survey has not the purpose of a question, the survey-title enables the survey menu bar and a box around the whole survey. You still have to add single ballots (votes) into its body

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 27, 2018 in Portfolio for Jira

Introducing a new planning experience in Portfolio for Jira (Server/DC)

In the past, Portfolio for Jira required a high degree of detail–foresight that was unrealistic for many businesses to   have–in   order to produce a reliable long-term roadmap. We're tur...

2,682 views 18 21
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you