Top Gifter Leaderboard
Ranks the top 10 viewers by the number of coins they've given.
Five data sources
Unlike the other gift overlays, the Leaderboard ranking doesn't have to be limited to the current live.
| Data Source | Shows |
|---|---|
| Realtime | Data from the current live |
| 7 Days | Total over 7 days |
| 14 Days | Total over 14 days |
| 30 Days | Total over 30 days |
| This Month | From the 1st of the month until now |
Realtime resets every live, so viewers who support you regularly in small amounts never show up. A 30-day source or This Month makes their loyalty visible and gives them a reason to keep coming back.
This Month works well if you run monthly prizes, because the period is clear and easy for viewers to understand.
Add the overlay
Open the Top Gifter menu in the dashboard, find the Install Overlay in OBS / TikTok Live Studio card, and copy the overlay link. Paste it as a Browser Source in OBS, or add it through Add Source → Link in TikTok Live Studio, at 1920 × 1080.
Use the Customize button on the same card to change how this overlay looks.
Never installed an overlay before? Read Installing Overlays in OBS & TikTok Live Studio first. It walks through each step.
The Leaderboard link is on the Leaderboard sub-page, separate from the Gift History and Running Text links.
Important settings
The Customize button:
| Setting | What it does |
|---|---|
| Select Font, Font Size | Typography |
| Line Spacing, Letter Spacing | Text density |
| Username Font Color, Point Font Color, Rank Font Color | Color of each part, set separately |
| Show Rank | Rank number |
| Show Crown | Crown icon for the top rank |
| Show Trophy | Trophy icon |
| Show Coin Symbol | Coin icon next to the number |
| Coin Animation | Animates the coin icon |
| Right Align | Aligns the list to the right |
The Test button sends a sample to the overlay. The Preview section in the dashboard only shows how it looks.
Reset Leaderboard
The confirmation reads: "All current realtime ranking data will be deleted and cannot be recovered."
Note the word realtime: it deletes the ranking for the current live. Think twice before pressing it mid-live, because viewers who have already gifted will lose their spot.
Common problems
Symptom: the leaderboard is empty even though people have gifted. With the Realtime data source, the ranking only includes gifts from the current live. Switch to 7 days to confirm the data is there.
Symptom: the ranking doesn't change after switching data sources. Reload the Browser Source in OBS.
Symptom: the names shown differ from the ones in Gift Tracker. They count different things. Gift Tracker records the current session in your browser. The Leaderboard can show a range of several days from the server.