> For the complete documentation index, see [llms.txt](https://smuddgge.gitbook.io/leaf-3.3.0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smuddgge.gitbook.io/leaf-3.3.0/commands/other-types/list.md).

# list

Displays a list of players that are online. This could be a staff list.

{% code title="Example" overflow="wrap" %}

```yaml
stafflist:
  type: "list"
  enabled: true
  name: "stafflist"
  permission: "leaf.stafflist"
  header: "&8&m&l-----&r &a&lStaff List &8&m&l-----"
  footer: "&8&m&l--------------------"
  list:
    admin:
      permission: "leaf.rank.admin"
      header: '&7[&f%amount%&7] &c&lAdmins'
      # Placeholders will parse in terms of the player.
      section: '&7- &f<player> {server_formatted}'
    moderator:
      permission: "leaf.rank.moderator"
      header: '&7[&f%amount%&7] &a&lMods'
      section: '&7- &f<player> {server_formatted}'
    helper:
      permission: "leaf.rank.helper"
      header: '&7[&f%amount%&7] &b&lHelpers'
      section: '&7- &f<player> {server_formatted}'
```

{% endcode %}