> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/hyperskill-studio-authoring/state-machine-reference/actions/leaderboard.md).

# Leaderboard

Leaderboard records attributes, such as time spent in the simulation, and ranks them for display. A detailed explanation of controls and interface functions is described in the section [State Machine Builder User Interface](https://docs.google.com/document/d/1-o5qSv4zTkzj7YSmRTkV4zezFq7lwU00FyTy0kw1l1U/edit#bookmark=id.6vu41emx3478).

1. Within the edit Simulation section of the HyperSkill Desktop application, navigate to the State Machine tab.
2. Click on the desired state and, from the dropdown in either the entry or exit actions, select the type Leaderboard.
3. Press the + button to add the action to the action list.
4. Next to the Currently Recorded dropdown, press the Expand button. A menu opens showing the attributes that can be recorded or used for display in the Leaderboard. By default, only Time Spent In Simulation is available to add, but any Player Attribute can be added as well.
5. Next to each attribute you want on the Leaderboard, select the + button. This moves it from the left column to the right column, which lists the attributes included in the leaderboard.
6. Choose the sort order of records: Ascending (lowest value on top) or Descending (highest value on top).
7. Use the Up and Down arrows on the right side of the panel to adjust the priority at which values are ranked.
8. To remove a variable from the Leaderboard scoring, press the delete button to the right of the recorded variable.
9. When you are done, press the Save button.