# Set Up a Leaderboard
Leaderboards rank your program participants alongside others to incentivize them to complete program objectives and encourage competition for the top ranks. You can add a leaderboard to your verified access widget or microsite and customize it like other components.
Leaderboards can be configured in a variety of ways to best suit the goals of your program. For more information on the different options, see [Leaderboards Explained](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained).
{% hint style="warning" %}
This feature is only accessible to specific impact.com editions or add-ons. [Contact us](https://app.impact.com/support/portal.ihtml?createTicket=true&) to upgrade your account and get access!
{% endhint %}
{% stepper %}
{% step %}
#### Step 1: Get leaderboards enabled
Before you can begin setting up leaderboards, reach out to your Program Strategy Manager (PSM) or create a [support ticket](mailto:advocate-support@impact.com) to have the Leaderboards feature enabled for your program.
{% endstep %}
{% step %}
#### **Step 2: Add leaderboard to widget or microsite**
1. Navigate to your widget or microsite by selecting  **\[Engage] → Content → Edit widgets** or **Edit content**.
* If you haven't set up a widget or microsite yet, you'll need to do so first.
2. Select the widget or microsite page you want to edit.
* Learn how to [edit widget content](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets) or [edit microsite pages](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages).
3. From the right sidebar menu, expand the **Leaderboard** component.
* If you do not see the *Leaderboard* component, you'll first need to install a Mint Components package:
* **Install Mint Components for widget**
1. From the left sidebar menu, select **Packages → Add package**.
1. On the *Mint Components* card, select **Add**.
2. You should now be able to expand the **Leaderboard** component in the right sidebar menu.
* **Install Mint Components for microsite**
1. Return to the *Content* screen by selecting **→ \[Engage] Content** in your left navigation bar or your top menu.
2. On the *Microsite* card, select **Edit settings**.
3. Scroll until you see the *Packages* field, then select **Add package**.
4. On the *Mint Components* card, select **Add**.
5. Select **Save config** and return to the editor.
4. Select a type of **Leaderboard**.
* For a description of each of the available leaderboards, refer to [Leaderboards Explained](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/leaderboards-explained#leaderboard-types-0-0).
5. Select the blue **Add to** button on the canvas where you want the component to appear.
{% endstep %}
{% step %}
#### **Step 3: Customize leaderboard**
{% tabs %}
{% tab title="Edit" %}
1. On your canvas, select the leaderboard component you want to edit.
2. Use the options in the **Edit** tab of the right sidebar menu to change the leaderboard properties.
* If you want to insert a link into a text component, you can do so by selecting  **\[Code view]** and editing the widget or microsite’s HTML.
3. Select **Save Draft** when you're done.
**Edit fields reference**
| Setting | Description |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Unknown user text | Enter the default display name for users without names, e.g., *Anonymous User*. |
| Hide viewing user | Toggle on to make the viewing participant's row hidden if they don't fall among the top displayed ranks. |
| Leaderboard time interval | Enter a start and end date for which you want to view leaderboard results, in the form `mm/dd/yyyy`. |
| Leaderboard type | Select the scoring system you want to use. For more information on the scoring systems available, see [Leaderboards Explained](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained). |
| Maximum rows number | Enter the maximum number of rows to be displayed on the leaderboard. |
| Program | Select a program to limit leaderboard results to participants in that program. To view results globally across all programs, don't select a program. |
| Rank type | For more information on the types of ranking systems available, see [Leaderboards Explained](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained). |
| Rank column heading | Enter the column name you want displayed for the *Rank* column. |
| Show leaderboard rank |  **\[Toggle on]** if you want the leaderboard to display the *Rank* column. |
| Stats column heading | Enter the column name you want displayed for the column containing participant scores. |
| User column heading | Enter the column name you want displayed for the column containing participant names. |
| {% endtab %} | |
{% tab title="Move" %}
1. On your canvas, select the component you want to move.
2. Select  **\[Move]**.
* Some components can’t be moved. The  **\[Move]** option will only appear if there’s another valid location on the canvas for the component to relocate to.
3. Select the blue **Move to** button where you want the component to go.
4. Select **Save**.
{% endtab %}
{% tab title="Remove" %}
1. On your canvas, select the component you want to remove.
2. Select  **\[Remove]**.
3. Select **Save**.
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}
