> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating & Managing Custom Leaderboards

> Set up custom leaderboards and milestone-based awards to incentivise and engage employees.

<iframe src="https://app.trupeer.ai/embed/FEC6tp1rT" width="100%" height="450" frameborder="0" allowfullscreen style={{borderRadius: '12px', border: 'none', display: 'block'}} />

## Steps

<Steps>
  <Step title="Navigate to Manage Leaderboards">
    Go to **Reports and Admin → Programs → Manage Leaderboards**. Here you'll see all existing leaderboards. Click **Create Leaderboard**.
  </Step>

  <Step title="Enter basic details">
    Fill in the leaderboard's name, description, score name, winner title, start date, number of winners to display, and frequency (monthly, quarterly, half-yearly, or annually).
  </Step>

  <Step title="Select or create events">
    Click **Continue** and choose the events you want to incentivise. You can use **system-defined events** or create **custom events**.

    To create a custom event: click **Add New Event** → enter event name and a unique event code → upload a CSV file with the relevant data. At least two events are required to set up a leaderboard.
  </Step>

  <Step title="Define eligible users">
    Choose which users are eligible for this leaderboard by selecting from existing groups (e.g., a specific team or business unit).
  </Step>

  <Step title="Set visibility">
    Choose whether the leaderboard is **public**, **member-only**, or inherits from current group settings.
  </Step>

  <Step title="Define awards and milestones">
    Select the awards for leaderboard winners. Click **Add Milestones** to define multiple milestones — each with a name, score threshold, and description. Optionally attach a gift or award to each milestone and customise the winner notification email.
  </Step>

  <Step title="Create and upload data">
    Click **Create Leaderboard**. Once created, upload data for custom events using the provided template and the unique event codes you defined. The leaderboard will automatically populate and rank winners.
  </Step>
</Steps>
