Skip to main content

Loyalty: Leaderboard Overview

Natalia
Updated

Loyalty.png
Understanding Your Community Leaderboard

Your leaderboard provides various views of your community's standings based on their loyalty currency.

Key Features

  1. Points Management: Adjust a viewer's points directly.
  2. Leaderboard Tabs: Navigate through different tabs to get comprehensive insights into the standings.
  3. Twitch Extension: Customize your leaderboard using the Twitch extension for a tailored experience.

This article covers all these aspects to help you make the most of your community leaderboard.

Accessing the Leaderboard

  1. Navigate to the 'Loyalty' Section:
    • Go to the 'Loyalty' section of your dashboard.
    • Click on the 'Leaderboard' tab.

Understanding the Leaderboard Options

Once you have the loyalty system enabled and active viewers, you will see the following options:

  1. Public Leaderboard:

    • Click this button to view the leaderboard page visible to both you and your viewers.

  2. Give Points:

    • Use this button to add points to a specific Twitch username. For example, you can add points to "chocotaco" and "danucd".

3. Reset:

      • This button resets the leaderboard but does not affect watch time.

Leaderboard Tabs

  1. Current Leaderboard:

    • Shows points earned from watching the stream and participating in chat mini-games.

  2. All-Time Leaderboard:

    • Displays points earned exclusively from watch time.

  3. Watch Time Leaderboard:

Lists the total minutes viewed by each viewer.

Additional Features

Edit or Delete Entries:

  • On the right side of each leaderboard, you can edit or delete individual entries.

Setting Up Commands for Your Leaderboard

To effectively manage your community leaderboard, you can set up specific commands that allow you to manipulate and track loyalty points for your viewers. Here’s how you can configure these commands:

Command Setup

  1. !setpoints USERNAME AMOUNT

    • Use this command to set a total amount of points for a viewer.

  2. !givepoints USERNAME AMOUNT

    • Allows a viewer to give points from their own stash to another viewer.

  3. !addpoints USERNAME AMOUNT

    • Adds the specified amount to a viewer's existing points.

Setting User Levels

  • Define User Permissions:
    • Configure who can use each command based on user levels.
    • Example: Set !givepoints for everyone and !addpoints, !setpoints for moderators only.

Important Notes

  • Enable Loyalty System:
    • Ensure that the Loyalty system is enabled for both points and watch time accumulation.
    • Watch time increments every 10 minutes during live streams; it does not accumulate during reruns.
  • Retroactive Watch Time:
    • Twitch does not track watch time retroactively, so it cannot be applied to viewers' totals after the fact.

 

Important Notes on Loyalty Distribution for Watch Time

  • Active Status Requirement:

    • Viewers must be logged into their StreamElements account and actively participate in chat by typing at least once. This action allows the bot to recognize them as an active user.

  • Avoid Collapsing Chat:

    • Collapsing chat on Twitch results in viewers being removed from the chat users list. To maintain active status and receive loyalty points, viewers should refrain from collapsing chat.

  • Full-Screen Viewing:

    • Viewing streams in full-screen mode can also lead to viewers not appearing in the user list, thereby preventing them from earning loyalty points. It's recommended that viewers avoid full-screen mode if they wish to accumulate watch time points.

Name Changes on Twitch

  • Impact on Loyalty Points:

    • Changing usernames on Twitch can affect the distribution of loyalty points. If a viewer changes their Twitch username, their previous loyalty data may not transfer automatically to the new username.

  • Using the !rename Command:

    • Streamers can enable the !rename command in their channel. Viewers who change their Twitch username should run !rename OldUsername in chat. This action ensures that their previous loyalty data is transferred to the new username, allowing them to continue earning points seamlessly.

How to Setup the StreamElements Leaderboard Twitch Extension

Follow these steps to configure the extension effectively:

Enable the Extension:

  • Navigate to your Creator Dashboard on Twitch.
  • Go to 'Extensions' under the 'Discovery' section to search for and install extensions, or view 'My Extensions' for already installed ones.


  • Activate and Assign Panels:

    • Once installed, activate the StreamElements Leaderboard extension.
    • Assign a panel to display the leaderboard on your Twitch channel.

  • Edit Panels on Your Twitch Channel:

    • Navigate to your Twitch channel and access the 'About' section.
    • Toggle on 'Edit panels' to create a panel specifically for the StreamElements Leaderboard extension.
  • Configure Extension Settings:
    • In your Twitch Extension manager, locate the StreamElements Leaderboard extension and click on the cog wheel icon to access settings.
    • Customize the displayed panels, set default options, and specify periods or usernames to filter.

Adding a Schedule (Optional):

  • You can add a schedule based on your timezone to automate when specific panels are displayed.
  • Once set, the scheduled panel becomes the default one shown in the extension on your channel.

Important Notes

  • Initial Data Collection:

    • When setting up the extension for the first time, it starts gathering data from chat interactions only after installation, activation, and configuration. It does not display past information initially.

  • No Data Displayed:

    • If you encounter 'No Data' under specific sections where you expect information, and believe events should be displayed (considering the account and extension have been active), contact StreamElements support via their contact form for assistance.

Related articles