BadgeOS Leaderboards


This Add-on to BadgeOS lets you easily create, configure and add leaderboards to your site.



This plugin adds a new “Leaderboards” option to the “BadgeOS” menu. Add as many Leaderboards as you like.

Leaderboard Example

Place Leaderboards anywhere on your site, including in-line on any page or post, using a simple shortcode. Hide or show user avatars or profile links if you have BuddyPress installed and configure other settings, like the number of users to show and the default column to sort by when the leaderboard loads.

BadgeOS Leaderboard Settings

A customizable “Leaderboard Widget” lets you choose what Leaderboard to show, and configure multiple display options:

Leaderboard Widget on BadgeOS


  • Create as many leaderboards as you like using a new Leaderboards menu in BadgeOS.
  • Choose the metric by which users should be ranked (points, the number of earned badges, or the number of any other earned achievements types you specify).
  • Configure each leaderboard so that is displays points, badges, and/or any other achievement type.
  • Add the shortcode provided for each leaderboard to any post or page on your site to instantly show the leaderboard.
  • Additional shortcode parameters available include: number of users to display; the default sorting metric; whether to show user avatars and profile links (if BuddyPress enabled).
  • Leaderboard Widgets: Choose any leaderboard to display as a widget. Options allow you to choose a title, the number of ranked users to show, the default sort metric to use, and whether to show user avatars and links to user profiles (if BuddyPress enabled).
  • Displayed leaderboards can be sorted by clicking the top of any column.
  • Leaderboard data updates automatically.
  • Refresh the data generating a leaderboard at any time.
  • Multiple leaderboards can be displayed in a single page or post.
  • Embed your leaderboards anywhere on your site!
  • New: LearnDash course based leaderboards
  • New: LearnDash group based leaderboards
  • New: Option to allow only selected user roles in leaderboards
  • New: Option to exclude users from leaderboards
  • New: Option to display yearly/monthly/weekly/daily/custom date range leaderboards

Example Uses:

  • Celebrate the leaders in your community or site
  • Encourage or incentivize others to get more involved
  • Create a sense of healthy competition to deepen engagement and progress
  • Showcase user success through multiple dimensions; each leaderboard you create can encourage a different category of involvement or achievement
  • Embed leaderboards in exactly the right place on your site to give users a push to get involved

Praise for Leaderboards:

“The plugin is amazing.  Exactly what we wanted.”
– John L., University of Illinois, Springfield

“This is a perfect addition to our BadgeOS site. We love the flexibility to define our own leaderboards. Thank you!
– Daniel S., New York City


If you do not already have the free BadgeOS plugin™ plugin (version 3.4 or higher) activated, you will need to do so before using this Add-on.


Version 1.1.12


View Change Log

View Documentation


Click Here For FAQs


Click Here For Support


If you have any questions about this addon, feel free to post in our public forum. You may also find answers to questions posted by other users. To read the addon FAQs, you can see the docs section.