Skip to main content

How to use the Leaderboard plugin

Create friendly competition in your app by ranking users based on points earned through actions, questionnaires, or loyalty activity.

S
Written by Support
Updated today

The Leaderboard plugin lets you rank users based on points and display those rankings inside your app. It’s commonly used for challenges, gamification, contests, and engagement programs where users can compete over time.

You control how users earn points, how often rankings refresh (daily, weekly, monthly, or overall), and whether points are entered manually or calculated automatically from other plugins like Questionnaires or Loyalty. The leaderboard updates dynamically as scores change, giving users a clear view of where they stand.

This plugin works well for fitness challenges, learning programs, employee engagement, community competitions, and rewards-based apps.

Requirements

  • Users must have an account and be logged in to collect points

  • If using Questionnaire or Loyalty scoring, those plugins must already be installed and configured

  • Resetting the leaderboard permanently clears all existing scores

How to use the Leaderboard plugin

  1. Log in, go to Builder in the left navigation

  2. Click the + button to open the Plugin Marketplace

    • Search for Leaderboard, then click Add Plugin

    • Name your plugin and choose whether to add it to the side menu, then click Add again

  3. Stay in the Content tab

    • Add optional intro content such as:

      1. Image carousels

      2. Descriptive text using the WYSIWYG editor

      3. Links or action items

  4. Click the Design tab

    • Adjust the visual layout of the leaderboard

    • (Optional) Enable Advanced Mode to customize styles with CSS

  5. Click the Settings tab

    • Choose how often rankings update:

      1. Daily

      2. Weekly

      3. Monthly

      4. Overall

      5. Or disable ranking changes entirely

    • Select how users earn points:

      1. Honor system: users manually add their own scores in the app

      2. Questionnaire scores: automatically pull points from one or more Questionnaires

      3. Loyalty points: calculate scores based on data from the Loyalty plugin

    • (Optional) Click Reset Leaderboard to permanently clear all scores and start fresh

  6. Click the Security tab

    • Turn on Require Login to ensure only logged-in users can view rankings

    • (Optional) Restrict access by user tags

  7. Click the Tagging tab

    • Add a tag to automatically apply to users when they open the leaderboard

  8. Click the Purchase tab

    • Require a one-time purchase or subscription to access the leaderboard, if needed

  9. Click the Analytics tab

    • View leaderboard performance, including:

      1. Opens

      2. Scores logged

      3. Top users

      4. Activity over 30, 60, or 90 days

  10. Click the Language tab

    • Customize labels, messages, and button text to match your app’s tone

Pro tips

  • Use Questionnaire-based scoring for fair, automated competition

  • Avoid frequent leaderboard resets unless you’re running time-boxed challenges

  • Clearly explain how points are earned in the intro content to prevent confusion

  • Combine Leaderboard with Loyalty for rewards-driven engagement

  • Keep ranking intervals consistent so users know when scores refresh

Did this answer your question?