In addition to manipulating a viewer's points, there are several tabs within the leaderboard to understand, as well as a Twitch extension for the leaderboard that has its own set of customization options. In this article we will discuss all of the above!
How do I access the Leaderboard?
Navigate to the leaderboard tab within the 'Loyalty' section of your dashboard.
Assuming you already have the loyalty system enabled and some active viewers in chat, you should see something like this:
There will be a few different options presented for you on this page:
- The 'Public Leaderboard' button will lead you to your public page that yourself and viewers can see.
- The 'Give Points' button will allow you to add a Twitch username and give them a certain amount of points (for example, chocotaco and danucd were added to the leaderboard via that option).
- The 'Reset' button will do just that
- Note: will not reset watchtime though
- 'Current' leaderboard shows all of the points viewers earned from both watching the stream and chat mini-games (shown above).
- 'All-Time' leaderboard shows all of the points earned onlyfrom watching the stream -
- You can see the different amounts and viewer\ user position in the table, as these show point earned from watchtime.
- The third tab is the 'Watch Time' leaderboard that shows viewers' total amount of minutes viewed -
- Note: On the right side, for all leaderboards, you can delete or edit individual entries.
Commands to setup for your leaderboard:
- !setpoints USERNAME AMOUNT will use the specified number to set a total amount for a viewer
- !givepoints USERNAME AMOUNT allows a viewer to give another viewer points out of their own stash
- !addpoints USERNAME AMOUNT adds the specified amount to a viewer's existing amount, assuming they are already on the leaderboard.
You can use !givepoints first, in case !add or !set don't work (might say 'user not found'). It should add the user to the leaderboard since they've received points, like the 'Give Points' button from your dashboard, and then !add\ !set should work).
Note: Make sure to set the user-levels for each command according to who you want to be able to run it. For example you can set !give for everyone and !add\ !set for mods.
Remember that for any sort of currency accumulation, the Loyalty system must be enabled. That goes for both loyalty points and watchtime.
Watchtime counts up every 10 minutes alongside Loyalty points, and only while the stream is live. Reruns will not be counted. Note: watchtime is not tracked by Twitch and there is no way to retroactively apply past watchtime to viewers.
Important items to note about loyalty distribution for watchtime:
- Viewers must be logged in to their StreamElements account, and type in chat at least once for the bot to recognize them as an active user
- Collapsing chat causes viewers to be removed from the chat users list - this is intended behavior from Twitch. Suggest viewers to avoid collapsing chat
- Same goes for viewing streams full screen - it will also result with the viewer not showing up in the user list
If one of the above conditions isn't met, viewers won't be distributed with loyalty points for watchtime.
Another scenario would be if they changed their names on Twitch.
If they have, make sure the !rename command is enabled in your channel, and have them run !rename OldUsername in chat. This should transfer previous loyalty data to the new username.
How to setup the StreamElements Leaderboard Twitch Extension:
In order to set up the extension you first need to enable it in your Twitch settings.
Step 1: Navigate to your Creator Dashboard > Extensions -
'Discovery' is where you can search for existing extensions to install, and 'My Extensions' shows extensions you've already installed.
The left side shows a couple of inactive installed extensions whereas the right side shows active extensions. Active extensions are enabled as panels in your Twitch channel.
Step 2: Assign a panel to the extension and activate it.
Step 3: Navigate to your Twitch channel > About section > toggle on 'Edit panels'. You can then create the panel for the installed, activated extension.
In your Twitch Extension manager you can press the leaderboard's cog wheel to access the extension settings -
It's pretty straight forward! Choose the displayed and default panels, periods you're interested to show or usernames you wish to filter. You can add a schedule if you want, based on your timezone. Once a schedule is set, though, it will become the default panel (the one that shows in the extension in your channel).
Note: when setting up the extension for the first time, it will not display past information that already exists on the account. It will start gathering data from chat only after it was installed, activated and configured, based on the above.
If you see "No Data" under a certain section and you believe these events should show there (since the account exists for a while and the extension is active for a while), please reach out to us via the contact form and let us know what is the issue that you see on your side.