Widgets
PremiumStudio → Overlays → Widgets32 settings8 min read
Widgets are layers that show live data from your stream and Discord. Add them from Widgets in the add panel; select one to see its Widget settings in the inspector, below a Test box. Most widgets also have an Appearance block (background, text color, corners, padding, font, background image) — and every widget can use the full Design & animation tab on top. The alert box has its own page: Alert box & designer.
How it works#
- Event-driven widgets (alert box, label, event list, count-up, hype meter, sub train, session stats, ticker) react to follows, subs, gift subs, bits, raids, channel-point redemptions and tips as they happen.
- Number widgets (goal, Twitch stats) use your real Twitch numbers, refreshed about every 90 seconds and topped up instantly by live events in between.
- Discord widgets (Discord stats, activity, voice) use your server's own data — something only a bot that runs both Discord and your stream can do.
- Config widgets (credits, sponsor, countdown, progress bar, custom HTML) show exactly what you type in.
Before you start#
Twitch connected (Streaming → Twitch Integration) for Twitch numbers and events. Kick/YouTube events also flow into event widgets.
For the leaderboard: Loyalty set up.
For Discord online count: the bot's Presence intent.
Set it up#
Part 1A follower goal5 steps
Open the editor
On the Overlays tab, click an overlay's thumbnail or its Edit button.
Add it
Widgets → Goals & counters → Goal.
Set the metric
Inspector → Metric Followers, Target 1000, Label Follower goal.
Count from today
To count only new followers, set Baseline to subtract to your current follower count.
Style it
Appearance → background rgba(10,13,22,.8), corner radius 20.
The bar shows e.g. 12 / 1000 and grows with every follow.
Every setting explained#
Alerts & events
| Alert box | Pop-up alerts per event with text, image/GIF/video, sound and text-to-speech. Full guide: Alert box & designer. |
| Event list | The most recent events as a list (Name followed, Name cheered 500 bits, …). Settings: Max items (default 8), Font size (16) + Appearance. |
| Label | One line of text with live tokens, e.g. Latest follower: {{latestFollower}}. Template (use + Insert token), Font size (32), Text color + Appearance. Tokens: latestFollower, latestSubscriber, latestGiftSub, latestCheer, latestCheerBits, latestRaid, latestRaidViewers, latestRedemption, latestTipper, latestTipAmount. |
| Ticker | A scrolling marquee with the same tokens as Label. Template, Speed (px/sec) (120 — stays the same speed however wide you make it), Font size (28), Text color + Appearance. |
| Emote rain | Images rain over the screen when anyone types the trigger in Twitch chat. Emote images (upload several), Trigger command (!hype), Cooldown (seconds) (10), Count (24), Duration (ms) (6000), Direction: Fall, Rise or Fly across. Size it to the whole canvas for a full-screen effect. |
Goals & counters
| Goal | A progress bar toward a target. Metric: Followers, Subscribers, Bits, Tips or Manual. Target, Label. Manual: type the Current value yourself. Others: Baseline to subtract — e.g. your follower count today, so the goal tracks +50 this month instead of your lifetime total. Uses your real Twitch number (every ~90 s); without Twitch it counts live events since the widget was added. FollowersSubscribersBitsTipsManual |
| Progress bar | A bar you fill by hand: Value, Max (100), Label, Bar color + Appearance. Change Value (or use it in an automation) to update it. |
| Hype meter | An energy bar that spikes on bits, subs, gift subs and raids and cools down when it's quiet. Decay time (seconds) (120) = how long one spike takes to fade, Label + Appearance. |
| Sub train | Appears as soon as 2+ subs/gift subs land within the window of each other and shows Label ×N; disappears when the window passes without a new sub. Window (seconds) (60), Label + Appearance. |
| Countdown | Counts down to a moment. Target date/time, Label, Completed text (It's time!) + Appearance — great for a Starting soon scene. |
| Count-up timer | Time since the last event of a type (e.g. time since last follow). Source event (Follow, Subscribe, Gift sub, Cheer, Raid, Redemption, Tip), Label + Appearance. |
| Session stats | This stream: new followers, subs and bits since the stream started. Label + Appearance. |
Chat & community
| Chatbox | Your live chat on stream. Max messages (20), Font size (16), Show mod/VIP/sub badges + Appearance. The editor fills it with your recent chat so it isn't empty. |
| Poll | Shows the poll a Channel Point reward started (Start Poll action — set the question and answers on the Channel Point Rewards page) and Twitch's own native polls automatically. Settings are only about the look: Idle text (shown when no poll runs), Results heading, Voting instructions, question/option font sizes, Bar color, Bar track color, and toggles Show bars, Show vote counts, Show percentages, Highlight winner (👑). |
| Leaderboard | Top Loyalty point holders, updated live when balances change. Title (Top Supporters), Show top N (10), Font size (18), Show point totals + Appearance. Set up Loyalty first. |
| Credits | An end-of-stream credits roll you write yourself. Title (Thanks for watching!), Scroll speed (px/sec) (60), Loop, and sections: each has a heading and one name per line. Add section adds one. |
| Discord stats | One Discord number: Member count, Online count, Boost count, Channel count or Role count, with a Label. Updates about every 20 s. Online count needs the bot's Presence intent. Member countOnline countBoost countChannel countRole count |
| Discord activity | New Discord members, live on stream. Max items (8), Font size (16) + Appearance. |
| Twitch stats | One Twitch number: Followers, Subscribers, Current viewers or Bits (all-time), with a Label. Polled every ~90 s; shows — until Twitch is connected. FollowersSubscribersCurrent viewersBits (all-time) |
Camera & socials
| Webcam frame | A frame with a transparent middle — put your webcam in OBS exactly under it. Style: Clean, Neon, Corners, Gradient, Retro, Glass. Color (+ Second color for Gradient/Retro), Thickness (1–40), Rounding (0–300, not for Retro), Name plate text (empty = hidden) with position Bottom left / Bottom center / Top left and Text color, Light up on alerts, and Cut a hole through layers below (backgrounds under the frame get a hole so the webcam shows through). CleanNeonCornersGradientRetroGlass |
| Socials | Your handles: up to 12 accounts on Twitch, YouTube, Kick, TikTok, Instagram, X, Discord or Custom. One at a time (rotate) with Switch every 2–60 s, or Show all. Style: Pill, Card, Minimal. Accent, Text color, Background. PillCardMinimal |
| Discord voice | Who's in a Discord voice channel, live, with mute and live status. Voice channel, layout List / Row / Grid, Avatar size (16–160), Max. members (1–25), toggles Names, Mute/live icons, Hide when empty, plus Accent, Text color and Background. The editor shows sample members while nobody is connected. ListRowGrid |
Media
| Media Share | A playlist of images, videos and sounds you trigger yourself. Add image / Add video / Add audio add items; each has a label and duration (ms) (8000). Play now shows an item on stream immediately; the bin removes it. |
| Now Playing | Your current Spotify song. It has no settings here: look, source and behavior are set once on the Now Playing page so it looks the same everywhere. Here you only set position and size. |
| Sponsor overlay | Rotating sponsor cards. Rotate every (seconds) (8); each sponsor has a name, an optional message and a logo. Add sponsor adds one. |
| Custom HTML/CSS/JS | Your own code, rendered in a sandboxed frame scoped to this widget. No Appearance block — your CSS controls the look. |
Test box (in the inspector)
What Test does depends on the widget.
| Event widgets | Pick an event (Follower, Subscriber, Gift sub, Bits, Raid, Channel points, Donation) and click Test — a TestUser event goes to the live feed, so both the editor and OBS react. |
| Chatbox | Type a test message and Send. |
| Discord activity | Test Discord join. |
| Emote rain | Test emote rain. |
| Number & config widgets | No test button: goal, progress bar, countdown, stats, sponsor and custom HTML show their real or typed values directly. |
Appearance
| Appearance | Shared by most widgets: Background color (default rgba(0,0,0,0.55)), Text color, Corner radius (default 16), Padding (default 16), Font (Sans-serif, Serif, Monospace, Display) and an optional Background image. |
Good to know#
Use Test data in the top bar while designing so every widget shows believable content even before your first stream.
Stats widgets show the same number in every overlay — you can place one in several scenes.
Custom HTML runs your own JavaScript in OBS. Only paste code you trust.
Troubleshooting#
The goal shows the wrong number
Check the Metric and Baseline to subtract — the bar shows current minus baseline. Real Twitch numbers refresh every ~90 s.
Twitch stats shows —
Twitch isn't connected yet, or the connection needs re-authorising. See Twitch Integration.
Discord online count is 0
The bot needs the Presence intent for online counts. Member/boost/channel/role counts work without it.
The poll widget never shows anything
It only shows while a poll runs: a Channel Point reward with the Start Poll action, or a native Twitch poll. Outside polls it shows the Idle text.
Was this page helpful?