> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Control Gameball Leaderboard on Widget?

> Learn about how Gameball's leaderboard work, and how you can hide it.

## Plan Availability

| **Platform** | **Plan**                           |
| ------------ | ---------------------------------- |
| Shopify      | Add-on for Pro / Available on Guru |
| Non-Platform | Add-on (Contact Support)           |
| Salla        | Add-on for Pro / Available on Guru |

Leaderboards can be a great tool to create a competitive environment and encourage your customers to be more active. However, leaderboards could also be demotivating if deployed within the wrong crowd. Gameball gives you the option to use it or to completely remove it when it is not convenient.

***

## How Does Gameball Leaderboard Work?

The leaderboard lets the customer track their progress and compare it to all your other customers.

The customer will be ranked based on their progress according to the [method of Tiering up](/product-documentation/programs/vip-tiers/tier-settings/tiering-up-methods) that you have configured in the Tier program. For example, if you chose "Amount Spent" to be the tiering up method, the customer will be ranked based on the amount they spent in comparison to other customers' spending.

To view the leaderboard, the customer needs to click on the **Progress bar** or the **Tier** found on the home section of the widget, then switch to the **Leaderboard tab**. The customer will then see their rank amongst other customers.

<Frame>
  <img src="https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/leaderboard-view.png?fit=max&auto=format&n=15226X8FGoPfo47L&q=85&s=89cc121bda39dd043d1468c4daabe8c0" alt="Leaderboard view in widget" width="2082" height="1134" data-path="images/product-docs/customer-widget/leaderboard-view.png" />
</Frame>

***

## How Can a Customer Know Their Exact Rank?

Customers can see their rank in comparison to the rest of the customers in the text above the customer list.

<Frame>
  <img src="https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/leaderboard-rank-display.png?fit=max&auto=format&n=15226X8FGoPfo47L&q=85&s=ca8066ea2fb16fbe8ea02651c3d68020" alt="Customer rank display on leaderboard" width="2086" height="1128" data-path="images/product-docs/customer-widget/leaderboard-rank-display.png" />
</Frame>

They can also filter the rank list according to:

* Today
* Yesterday
* This week
* Last week
* This month
* Last month
* This year
* All-time

***

## How to Show or Hide the Gameball Leaderboard from the Widget

<Steps>
  <Step title="Navigate to Visibility Settings">
    On the **Gameball Admin Dashboard**, go to **Widget > General: Visibility**.
  </Step>

  <Step title="Toggle Leaderboard Visibility">
    Under the **Leaderboard Tab**, check **Show** or **Hide** based on your objective.

    <Frame>
      <img src="https://mintcdn.com/gameball/15226X8FGoPfo47L/images/product-docs/customer-widget/leaderboard-visibility-settings.png?fit=max&auto=format&n=15226X8FGoPfo47L&q=85&s=8fcf8f35d9dea076b69b3b74e173d0b9" alt="Leaderboard visibility settings" width="2680" height="1410" data-path="images/product-docs/customer-widget/leaderboard-visibility-settings.png" />
    </Frame>
  </Step>

  <Step title="Save and Refresh">
    Click **Save**, then refresh your website. You will find that the leaderboard tab has been completely removed (or restored).
  </Step>
</Steps>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Customize the Widget Launcher" icon="rocket" href="/product-documentation/customer-widget/start-configuring-profile/customize-your-loyalty-launcher-to-fit-your-platforms-interface">
    Control the shape, position, icon, and visibility of your loyalty launcher button.
  </Card>

  <Card title="Customize Tabs Visibility and Order" icon="eye" href="/product-documentation/customer-widget/start-configuring-profile/customizing-tabs-visibility-and-order-in-gameball-widget-settings">
    Control which tabs appear in your widget and in what order they are displayed.
  </Card>
</CardGroup>
