The Ratings for Confluence app enables you to easily collect and display user-ratings on pages and blog posts in Confluence.

The app consists of two macros - the Rate Macro and the Rate Search Macro:

The Rate Macro can be placed onto pages to enable users to vote/rate content. Users who have voted can also retract their vote and re-cast it.


The Rate Search Macro can be used to display all the user ratings across multiple spaces, pages, blog posts and comments in Confluence.

How to use the Rate Macro

  1. Go to the page that you want to add the Rate Macro to, and clickat the top of the page

  2. Place your cursor where you wish to add the macro, then click the Insert More Content icon and choose Other macros at the bottom of the list

  3. In the Select macro window type 'Rate' in the search box to find the Rate Macro. Click on the macro to add it to your page.

  4. Select the required macro parameters then click Insert or Save.

  5. Click the Publish or Update button in the bottom right hand corner to view the Rate Macro on your page. The image below demonstrates the macro with the Vertical theme selected:

How to use the Rate Search Macro

  1. Go to the page that you want to add the Rate Search Macro to, and click thebutton at the top of the page.

  2. Place your cursor where you wish to add the macro, then click the Insert More Content icon and choose Other macros at the bottom of the list


  3. In the Select macro window type 'Rate' in the search box to find the Rate Search Macro. Click on the macro to add it to your page.

  4. Select the required macro parameters then click Insert or Save.
    Note: Ratings from several spaces can be displayed by adding multiple space keys in the Spaces box. You can also preview your settings before applying them.


  5. Click the Publish or Update button in the bottom right hand corner of the screen to view the Rate Search Macro on your page.


Table of contents