---
title: How to use the Leaderboard plugin
description: Create friendly competition in your app by ranking users based on points earned through actions, questionnaires, or loyalty activity.
---

[Skip to content](https://help.buildfire.com/how-to-use-the-leaderboard-plugin#main-content)

[![buildfire](https://help.buildfire.com/hs-fs/hubfs/bf-wordmark-black.png?width=150&height=35&name=bf-wordmark-black.png)](https://help.buildfire.com?hsLang=en-us)

Open main navigation

Close main navigation

- [Log In](https://app.buildfire.com/login)

[Log In](https://app.buildfire.com/login)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Buildfire Help Docs](https://help.buildfire.com/?hsLang=en-us)
2. [Add Functionality To Your App](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us)
3. [Plugins to drive engagement & community](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#plugins-to-drive-engagement-community)

# 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.

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

- [Buildfire Control Panel](https://help.buildfire.com/buildfire-control-panel?hsLang=en-us#main-content)

    - [Navigating the Control Panel](https://help.buildfire.com/buildfire-control-panel?hsLang=en-us#navigating-the-control-panel)
    - [Global Tools](https://help.buildfire.com/buildfire-control-panel?hsLang=en-us#global-tools)
    - [Terms & Policies](https://help.buildfire.com/buildfire-control-panel?hsLang=en-us#terms-policies)
- [Build Your App](https://help.buildfire.com/build-your-app?hsLang=en-us#main-content)

    - [Global Settings](https://help.buildfire.com/build-your-app?hsLang=en-us#global-settings)
    - [Building Your App's Navigation](https://help.buildfire.com/build-your-app?hsLang=en-us#building-your-apps-navigation)
    - [Building Your Login Flow](https://help.buildfire.com/build-your-app?hsLang=en-us#building-your-login-flow)
    - [Building a PWA](https://help.buildfire.com/build-your-app?hsLang=en-us#building-a-pwa)
- [Add Functionality To Your App](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#main-content)

    - [Plugins to drive engagement & community](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#plugins-to-drive-engagement-community)
    - [Plugins to drive monetization](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#plugins-to-drive-monetization)
    - [Plugins to run operations & workflows](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#plugins-to-run-operations-workflows)
    - [Plugins to show content & media](https://help.buildfire.com/add-functionality-to-your-app?hsLang=en-us#plugins-to-show-content-media)
- [Make Money With Your App](https://help.buildfire.com/make-money-with-your-app?hsLang=en-us#main-content)

    - [Overview](https://help.buildfire.com/make-money-with-your-app?hsLang=en-us#overview)
    - [Apple/iOS](https://help.buildfire.com/make-money-with-your-app?hsLang=en-us#apple-ios)
    - [Google/Android](https://help.buildfire.com/make-money-with-your-app?hsLang=en-us#google-android)
- [Publish Your App](https://help.buildfire.com/publish-your-app?hsLang=en-us#main-content)

    - [Overview](https://help.buildfire.com/publish-your-app?hsLang=en-us#overview)
    - [Apple/iOS](https://help.buildfire.com/publish-your-app?hsLang=en-us#apple-ios)
    - [Google/Android](https://help.buildfire.com/publish-your-app?hsLang=en-us#google-android)
- [Manage Your App](https://help.buildfire.com/manage-your-app?hsLang=en-us#main-content)

    - [Managing Your App’s Users](https://help.buildfire.com/manage-your-app?hsLang=en-us#managing-your-apps-users)
    - [Push Notifications](https://help.buildfire.com/manage-your-app?hsLang=en-us#push-notifications)
    - [Analytics](https://help.buildfire.com/manage-your-app?hsLang=en-us#analytics)
- [Connect External Partners](https://help.buildfire.com/connect-external-partners?hsLang=en-us#main-content)

    - [Google/Android](https://help.buildfire.com/connect-external-partners?hsLang=en-us#google-android)
    - [Apple/iOS](https://help.buildfire.com/connect-external-partners?hsLang=en-us#apple-ios)
    - [Zapier](https://help.buildfire.com/connect-external-partners?hsLang=en-us#zapier)
    - [Meta](https://help.buildfire.com/connect-external-partners?hsLang=en-us#meta)
    - [Segment](https://help.buildfire.com/connect-external-partners?hsLang=en-us#segment)

[![Group 4578 (1)](https://help.buildfire.com/hs-fs/hubfs/Group%204578%20(1).png?width=140&height=33&name=Group%204578%20(1).png "Group 4578 (1)")](https://buildfire.com/)

Copyright © 2026, Buildfire