# Leaderboard widget

> Ranked list surface for the buddy's audience.

Source: https://docs.hatched.live/docs/reference/widgets/leaderboard

## Mount

```html
<script
  src="https://cdn.hatched.live/widget.js"
  data-embed-token="EMBED_OR_SESSION_TOKEN"
  defer
></script>

<div data-hatched-mount="leaderboard"></div>
```

## Required scopes

- `read`

Leaderboards are read-only in the widget runtime. Use your server-side SDK for
admin configuration and metric ingestion.