Skip to main content

Top Gifter

The Top Gifter menu holds several gift-related overlays: a history of incoming gifts, a running text with the gifter ranking, and the Leaderboard, which has its own page.

Before you start​

Your TikTok Live must be connected.

Gift History​

Shows gifts as they arrive, one at a time.

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.

Settings under the Customize button:

SettingWhat it does
Select Font, Font SizeTypography
Line Spacing, Letter SpacingText density
Font Color, Background ColorText and background colors
AnimationHow new gifts appear
Disappear afterHow long an entry stays
Minimum coinsGifts below this value are not shown
MinimalistCompact layout
Profile PhotoShows the sender's profile photo
Show coinsShows the coin amount
Additional TextExtra text next to each entry
Use "Minimum coins" on busy lives

When small gifts keep pouring in, the overlay fills up and the big gifts get buried. Raise Minimum coins so the overlay only shows gifts worth highlighting.

Top Gifter | Running Text​

A running text (marquee) with the gifter ranking. It has more settings than any other overlay, split across four tabs.

Maximum 10 gifters

The dashboard says: "Maximum 10. Gifter data is not sent beyond that." Entering a bigger number won't show an 11th gifter.

Motion tab​

SettingWhat it does
SpeedHow fast the text moves
Gap Between RepeatsSpace between copies of the text
Scroll DirectionTo the left or To the right
When Text Is Shorter Than the ScreenKeep scrolling or Stay still if it fits

Above the preview there's a measurement line such as ≈120 px/second · strip 800px · 6 s/cycle · 3 copies. Use it to set a comfortable reading speed instead of guessing numbers.

Pick "Stay still if it fits" when there are few gifters

Early in the live, with only two or three gifters, text that keeps moving even though it fits on screen is harder to read. Stay still if it fits keeps it still until the content is long enough.

Bar Style tab​

SettingWhat it does
Transparent (OBS)Removes the bar background
Bar HeightAutomatic or Fixed
HeightThe height value when you pick Fixed
Horizontal Padding, Vertical PaddingSpace between the content and the bar edges
Corner RadiusHow rounded the corners are
Edge FadeText fades out at the left and right edges instead of being cut off sharply

Text tab​

SettingWhat it does
Font Weight, Italic, UppercaseLetter style
Outline Width, Outline ColorText outline
Text Shadow, Shadow Color, Shadow BlurShadow
Shadow Offset X / YDirection the shadow falls
You almost always need an outline or shadow

Running text usually sits on top of gameplay. Without an outline or shadow, the text disappears whenever the background behind it is bright.

Content & Separator tab​

SettingWhat it does
Separator Between GiftersLine, Dot, Dash, Slash, No separator, or Custom
Custom SeparatorYour own separator text, if you picked Custom
Show Rank NumberShows the ranking order
Coin FormatHow the coin amount is written
Additional Text PositionIn front, Behind, Front & behind, Alternating, or Hide

Coin Format uses the {coin} marker as the spot for the number. Example from the dashboard:

({coin} Coin)

Common problems​

Symptom: the running text is empty. Nobody has sent a gift this session yet, or Minimum coins in Gift History is set so high that nothing gets recorded.

Symptom: the 11th gifter and beyond don't appear. That's a system limit, not a settings mistake. The maximum is 10.

Symptom: the running text preview doesn't show. The message reads: "Preview is not available yet. You can still change and save the settings." Your settings are still saved.

Symptom: the bar has a black background but you want it transparent. Turn on Transparent (OBS) in the Bar Style tab.

See also​