Widgets
Levels board widget
Show your Discord server's top members by XP on your website.
The levels board shows your Discord server's top members by XP, with avatar, rank and level. It is the same ladder members climb in Discord, kept in sync for you.
What you need#
- Your Discord server listed on the Dispresso directory and approved (not marked 18+).
- Leveling turned on, so members have XP. See the Leveling guide.
- Somewhere on a website that lets you paste HTML.
Find your server id#
- 1In Discord, open User Settings, Advanced and turn on Developer Mode.
- 2Right click your server icon and choose Copy Server ID.
- 3Paste it as
data-guild. If your server has a vanity link on Dispresso (dispresso.co/servers/your-name), that name works as well.
Paste it#
<div data-dispresso-levels data-guild="YOUR_SERVER_ID" data-limit="10"></div>
<script src="https://dispresso.co/widgets/levels-board.js?v=3" async></script>Replace YOUR_SERVER_ID with the id you copied. How to paste it into your site builder is in Put a widget on any website.
Options#
| Attribute | What it does | Default |
|---|---|---|
data-guild | Your server's id or vanity name. Required. | None |
data-limit | How many rows, 1 to 25 | 10 |
data-theme | light, dark or auto | auto, the visitor's system theme |
data-accent | A hex color such as #5865f2, or blue, violet, green, teal, pink, red, amber, orange, slate | Dispresso orange |
data-size | full or compact | full |
Width, corner radius and font beyond that: give the div an id, as shown under Styling in the widgets hub.
Common mistakes#
| What you see | Usually because | Fix |
|---|---|---|
| The widget says the board is not public right now | The server is not listed on the directory, is not approved yet, or is marked 18+ | List it with /bump (see the Server directory guide). Once approved the board appears with no other change. |
| It says no one has XP yet | Leveling is off, or nobody has talked since it was turned on | Turn on the leveling module and chat. The board fills on its own. |
| Nothing appears, not even a message | The div and script were pasted into a builder that strips scripts, or the script tag was cut off | Paste both lines together, and check your builder allows custom code. See Put a widget on any website. |
Questions people ask#
Whose names are shown?#
The display name, avatar and level of the top members, the same details Dispresso's public leaderboards already show. Nothing private, no messages, no balances.
Can members hide themselves?#
The board follows the server's public leaderboard. Ask staff to adjust who is ranked from the leveling settings.
How many can it show?#
Ten on a free server. A server with Server Boost or Elite can set data-limit up to 25.
Can I remove the Powered by Dispresso link?#
Yes, on a server with Server Boost or Elite. Free servers keep the small link. It follows the plan, so it comes back if the plan ends.
How fresh is it?#
Answers are cached for a short time, so a busy page never becomes a flood of requests to Discord.