Articles on: Games & Experiences
This article is also available in:

Enable the Leaderboard

Leaderboard display type


This determines how players will appear on the leaderboard, and depending on what you choose, will either pull from your data collection form or a remote JSON file to populate it.


Maximum number of entries to show in the leaderboard


This determines how many entries and lines in the table are to be displayed between 5 and 100.


Score aggregation (not applicable to the Combo™ or Dynamic Path™)


In the event that a participant plays several times, you may choose the score aggregation method based on the unique identifier, email address, user name, or phone number (or opt not to aggregate the scores).


Please note, your chosen method must be available as a field within your data collection form.


Leaderboard timeframe


The Leaderboard Timeframe setting allows you to define the period of time for which player scores and results are displayed. By selecting a specific timeframe, you can highlight performance based on daily, weekly, monthly, or fully customised periods.


Available options:


  • All Time – Displays all results since the leaderboard was first activated.
  • Current Day – Shows scores only from today.
  • Previous Day – Shows scores from yesterday.
  • Current Week – Displays results from the ongoing calendar week.
  • Previous Week – Displays results from the last calendar week.
  • Current Month – Displays results from the ongoing calendar month.
  • Previous Month – Displays results from the last calendar month.
  • Current Quarter – Displays results from the ongoing calendar quarter.
  • Previous Quarter – Displays results from the last calendar quarter.
  • Current Year – Displays results from the ongoing calendar year.
  • Previous Year – Displays results from the last calendar year.
  • Custom Dates – Lets you manually select a start and end date to define the leaderboard timeframe.
  • Relative Period – Allows you to set a rolling period (for example, the last 7 days, last 30 days, etc.), independent of fixed calendar dates.


Filter the Leaderboard by Date (Query String Parameters)


It is possible to display the leaderboard for a specific date range by adding query string parameters to your game URL.

Available Parameters


You can use the following parameters:

  • leaderboardStart
  • leaderboardEnd


These allow you to define a custom start and end date for the leaderboard results displayed.


Example


https://yourgameurl.com?leaderboardStart=2024-01-01&leaderboardEnd=2024-01-31


In this example, the leaderboard will only display results between January 1, 2024 and January 31, 2024.


Important Notes


  • Dates must be formatted as: YYYY-MM-DD
  • Both parameters can be used together to define a specific period
  • If no parameters are provided, the default leaderboard configuration will apply
  • These parameters must be added to the end of your game URL


Additional options


Additionally, you can enable or disable options to:


  • Display the time
  • The number of entries
  • Deactivation date – this will make the leaderboard accessible independently of the application’s activation dates.
  • A button below the leaderboard to return to the start of the app


There is also a leaderboard deactivation date field, which will take priority over the application end date, if for example, you wanted to display the leaderboard for longer via its own direct link (which can be found in the Publish creation step).


Updated on: 24/02/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!