Karma, Medals and Badges!

You want more fun while working? Writing blog entries, commenting on other articles and simply using Confluence on a daily basis with even more fun. Even if you already have successfully established Confluence, the Plugin Karma offers you additional value. Your Wiki offers a few functions that are probably as good as never used – what a shame for all the great effects! Do you and your colleagues update your statuses daily? Do you tag key words in every blog entry to make the search for content easier? No? Then just wait until you have installed Karma. Using all these functions gives you Karma points. Karma for Confluence offers your Wiki a new kind of power and more fun, even for the most enthusiastic user. Get in the competition and earn some Karma!


So, what will give you the big points? Actually this depends on your Karma configuration in the administration, but here is the list of the standard Karma setting.

+15 pts.

Create a blog post

+10 pts.

Create a page

+3 pts.

Create a comment

+5 pts.

Label a page or blog post

+10 pts.

Other people like your content

+2 pts.
Update your user profile information

+2 pts.

Write a Status Update

+2 pts.

Follow someone

+10 pts.

Someone is following you

+20 pts.

Create a personal Space

  +3 pts.

Edit a blog post

+15 pts.Upload a new profile picture

  +3 pts.

Edit a page

  +2 pts.

Follow a space

  +2 pts.

Follow a page

  +2 pts.

Follow a blog post

+30 pts.

Receive a medal

+10 pts.Add internal links

Karma for each user

In general, the number of collected Karma points is shown behind the names of the users. Here are some examples:


Someone made your day today? Show it and award a medal. If you want to have your own set of Medals, you can change them in the Karma configuration.

Hero of the day
Busy Bee
Life Saver
Thank You
Great Time

By default, you can give two medals per day, so choose wisely. You can award a medal either by using the Karma Overview or via the hover profile card of a user:

(P.S.: Receiving a medal will give you some Karma Points, too!)


Besides Karma, you can obtain badges for particular actions or an accumulation of activities. Nearly everyone can get the Badge ‘Mayfly’. But will you be able to land the titles of ‘Label Neurotic’ or ‘Morning Bird’? So, if you are active, you will be rewarded with the acquisition of badges. (Psssst, if it's too easy or too hard to receive a specific Badge, you can configure it in the Karma configuration.)

Message in a Bottle

Write a comment

Hello World

Update your Status

Wet paint!

Create a new page


Create a new blogpost


Add a label


Follow someone

Love Letter

Get 30 likes for one comment, page or blogpost

Mirror mirror on the wall

Upload a profile picture

Morning Bird

Login to the system before 8am

Night Owl

Login to the system after 9pm


At least 30 people follow you


Write 100 Comments

Label Neurotic

Label 1000 pages or blogposts

Like an open book

Write 1000 status updates

Newspaper Man

Add 1000 pages or blogposts

I am what I am

Maintain your profile

Add 100 internal links

Challenge Cups

The user with most Karma in a certain timeframe (overall, year, month, day – see Karma Ranking) automatically receives the Karma leadership Badge for this timeframe. While he or she is in possession of the leadership, a colorful frame is added to his profile picture everywhere on Confluence to show the others that he currently has most karma for the respective period of time. As soon as another user passes him, the Badge and the frame are passed on to the following leader.


Whenever you or someone you follow receives a new medal or badge, you will get a notification via email or the Confluence Workbox at the upper right:

You don't want an email? No Problem: In your own Karma Overview click the Button "Configuration". It is located in the upper right corner of the screen. Simply deselect the email notifications in the pop-up and you won't receive them anymore.

The Karma Overview

 You can reach it via the user profile view or the user dropdown.

The Karma Overview provides detailed information about Karma Points of a single user. You can have a look at your Karma Overview, but also the one of your team members.

It is divided into four parts: Karma History, Karma Ranking, Medals, Badges


Karma History

The Karma History consist of a graph which shows your current Karma progress and the last 20 Karma Point events listed below. This graph will be updated once a day. In the list you can see, what you did for your Karma. When you have been awarded a medal, additionally the text, why you were such a good guy, is shown. The top right link on this column leads to a dialogue that shows all actions which you can get karma for.

Karma Ranking

Karma Ranking lists all users which already gained Karma sorted descending by the Karma Points they earned overall, in the last 365 days, in the last 30 days or in the last 24 hours (more info, see Challenge Cups). The currently selected user is highlighted in green and therefore it is easy to find the current ranking. This allows you to immediately see how many points you still need to surpass your team colleagues. When you click on the profile of a colleague, you will come to their Karma Overview.


In this area you can see, which Medal the Karma User was awarded yet and how often. The top right link will give you an overview on all available badges. Futhermore, there is a "Medal History" that shows the last 20 awarded medals for that user.


The last column shows the current status of the Karma Users badges: achieved ones and in progress. The top right link on this column leads to a dialogue with all available badges.

I don't want the fun with Karma!

What a pity! But here we go: In your own Karma Overview click the Button "Configuration". It is located in the upper right corner of the screen. Simply deselect your participation in the pop-up and you won't be listed anymore. If you want to join again, you won't have to start from the scratch. Just select the participation again and you will start, where you left (except the configuration is set to lose Karma over the time, if you are not active.).


"Karma Medals"


Show the medals in your system. Who is giving whom a medal. Filter to a specific user or show all user medals.

showgroupedmedalstrueDisplay the medals grouped by its type
showmedalstreamtrueShow the last 20 medals
medalusernoneFilter the medal history to a specific user. Leave it blank to show the history off all users

"Karma Ranking"


Insert the Karma Ranking into a page.

users Select which users should be displayed. If none is selected, all users with Karma Points are being displayed.
timeframeMONTHWhich timeframe should be preselected in the macro? The viewer can change to other timeframes on the page.
pagesize20How many users should be displayed per page?



Karma Configuration

In the Administration of Confluence you have the option to configure Karma.

General Configuration

  • You can decide whether or not Karma Points are shown on each user link.
  • You are able to configure the delivery of notifications to the users
    • DEFAULT Only to the peoples network (Followers)
    • To all users

Karma Events

You don't want to give Karma, when you search for something? You want to receive more Karma on the editing of a page? You want that your users have to regain Karma? No problem! In the Karma Events section you can choose for each event, if it will give Karma and how much Karma Point is earned by doing so.

Furthermore you can define, how much Karma will be lost (or gained) over the time. This affects all users, but it won't decrease Karma Points from a user, who has 0 Karma Points. If you want to regularly decrease 5 Karma Points you need to fill in "-5". To schedule the interval of the in- or decrease you need go to the "Scheduled Jobs" administration. Choose "Edit" on the "Karma Decrease/Increase Job" and define the new interval via Cron Expression.

You can go back to the standard setting by clicking the reset button.


Configure the badges to match your needs! There are several things you can change on a badge:

Activated - Define whether you want to have this badge available or not.
- Insert a new badge title.
Description - Type in a new description for the badge.
Icon URL - Define an alternate badge icon! Simply insert the URL to your new icon. You can attach new icons to a Confluence page and reference the attachment URL.
Parameters - Some badges have parameters you can change. The parameter values can also be used in your badge title or badge description by using the syntax ${parametername}


You want to change you medal appearance? OK, here we go! These are things you can change on a medal:

Activated - Define whether you want to have this medal available or not.
Icon URL - Set an alternate medal icon! Simply insert the URL to your new icon. You can attach new icons to a confluence page and reference attachment URL.
Title - Insert a new medal title.

Additionally you can define how much medals per day a user can award to another user. The standard is 2.


  1. Unknown User (mrjcleaver)

    As an administrator, although I do want my users to follow other users, I don't want them to have to receive "new medal or badge notifications." I think the settings should be separable. I've had several comments in the last day, including this one:

    Is this badge thing going to be like the constant notifications from my mother in law about her accomplishments in Candy Crush?  

    1. Unknown User (shf)

      Hello Unknown User (mrjcleaver),

      thank you for your feedback. I've created a new requirement on your behalf: Unable to render Jira issues macro, execution error. (Though our notifications are far more valuable for our users than the ones from Candy Crush (wink) ). Is it important for you to turn off notifications globally? What do you think about having a user setting, so that every user can decide to receive notifications or not? I am keen on your feedback!



      Stephanie Hoffmann
      Communardo Support

      1. Unknown User (mrjcleaver)

        I tried commenting on KARMA-137 but I don't have permissions.

        Well, I definitely would like to default it off. 

        Sure, users could override the admin default I suppose, but I don't see the harm if they want to use it. 

        I guess a "disable" and "change everyone's setting" could be useful also.

        Thanks, M.

        1. Unknown User (mrjcleaver)

          In the meantime, is there any way (e.g. disable module) to disable the emails without telling people to unfollow?


          1. Unknown User (shf)

            Hello Unknown User (mrjcleaver),


            thank you for your thoughts. I've updated the issue and added them. Unfortunately it is not possible to turn off the notification in any other way than unfollowing.

            Thanks for helping us to make our plugin better.



            Stephanie Hoffmann
            Comunardo Support

  2. Unknown User (jwhitene)

    We would love it if there was an option to upload custom metals/badges/awards.  Or instructions how to do it manually by touching the DB / confluence-home (or wherever Karma stuff is stored). 



    1. Unknown User (shf)

      Hello Unknown User (jwhitene),

      I am happy to announce that this feature will be part of the next Karma Release. Please have a look at Unable to render Jira issues macro, execution error.  for further information on this feature.



      Stephanie Hoffmann
      Communardo Support 

  3. Unknown User (carlm)

    Can Badges Per Day be fractions? E.g. 0.1 to limit badges to one every ten days. We want to use Karma scores as a small component of knowledge sharing KPIs for team members. Making badges rarer should prevent abuse.



    1. Unknown User (amb)

      Hi Unknown User (carlm),

      I'm sorry we missed your comment.

      I assume you are talking about medals because the "x per day" setting is part of their configuration. It is currently not possible to set the limit to fractions.

      Kind regards,

      Almuth Boehme
      Communardo Support