Skip to content
Docs

Goal Bar

Show progress toward a follower, sub, Bits, tip or custom goal that fills up live as your chat pushes it.

View as Markdown
On this page

The Goal Bar gives your viewers something to push for. It fills up as follows, subs, Bits or tips come in, celebrates when the target is reached and can move on to the next goal by itself.

Use it for a sub goal on stream day, a monthly donation goal or a custom goal you count by hand.

goal-bar widget, standard look
Previewgoal-barlookstandard

Add it

  1. Click Add in the toolbar (or press W) and pick Goal Bar under Alerts & Goals.

  2. In the settings card, choose the Goal type and set the Goal target.

  3. Pick a Goal period: this stream, all-time, daily, weekly or monthly.

  4. Drag the bar into place and choose a look with Choose a look.

Goal types

Goal typeWhere the number comes from
Follower goalTwitch follower totals
Sub goalTwitch sub totals plus new sub events
Bits / KicksBits and Kicks as they arrive
Donation goalYour Ko-fi donations
Custom goalOnly you and your mods, with chat commands
PointsLoyalty points your viewers collect with PXStudioBot

Follower and sub totals need Twitch connected under Twitch live totals; the donation goal needs Ko-fi donations. For sub goals, Sub goals count decides whether every sub counts as 1 or as sub points (Tier 2 = 2, Tier 3 = 6).

This stream follows your Twitch go-live. Daily, weekly and monthly goals reset at the Reset hour (0-23); Points goals use UTC midnight instead.

Chat commands

You and your mods can change the bar from chat. The default command word is goal; change it under Command word and Who can use commands.

  • !goaladd 5 and !goalsub 5 add or subtract
  • !goalset 50 sets the value directly
  • !goalmax 200 changes the target
  • !goalreset resets value and goal

Select the widget and the same controls show up above it: a value stepper, Reset, test events for follow, sub, Bits and tips, and Set target. They are also available in the Deck and on a Stream Deck.

Goal chains and milestones

  • Raise goal by bumps the target automatically every time it is reached.
  • Goal chain runs several goals in a row, written as Follower Goal:100;Sub Goal:150.
  • Milestones mark up to four steps on the bar, each with its own name and percentage.
  • Title format and Detail text take tokens like {current}, {goal}, {remaining} and {percent}.

Tips

  • Show on activity only hides the bar until something happens, then keeps it visible for a few seconds.
  • Celebrate how often set to Once per stream keeps the celebration special.
  • Turn on Vertical bar for a thermometer next to your camera.
  • Want several goals at once? Add one Goal Bar per goal, see Goals, timers and counters.

Looks

Pick a look under Look in the settings card. Every look is a complete style; colors and fonts you set yourself stay on top. 15 looks are available:

Command reference

Every chat command this widget understands, with the default command names. Values in angle brackets are placeholders, for example a number.

CommandWhat it does
!goaladd 5Add to the current value
!goalsub 5Subtract from the current value
!goalset 50Set the current value directly
!goalmax 200Change the goal target
!goalresetReset value and goal

Settings

All settings live in the floating settings card on the right of the editor. Defaults are what a new widget starts with.

Content

SettingDefaultValuesNotes
Goal typeFollower goal (Twitch totals)Follower goal (Twitch totals), Sub goal (Twitch totals + events), Bits / Kicks (events), Donation goal (Ko-fi), Custom goal (mod commands only), PointsTwitch totals need Twitch connected.
Goal target1001 to 10000000
Goal periodThis stream (Twitch go-live)This stream (Twitch go-live), All-time (never reset), Daily, Weekly (Mondays), Monthly (on the 1st)This stream follows Twitch go-live; Points use the server clock (UTC midnight).
Reset hour (0-23)40 to 23Local hour other goals reset at - Points ignore this. Only used for daily, weekly or monthly periods.
Sub goals countSubs (1 per sub)Subs (1 per sub), Sub points (Tier 2 = 2, Tier 3 = 6)Only used when the goal type is "Sub goal".
Rarity labelOnOn or offShow the decorative rarity text, such as COMMON or LEGENDARY. Used by the Loot Drop look.
Common labelCOMMONTextDecorative Loot Drop detail.
Rare labelRARETextDecorative Loot Drop detail.
Epic labelEPICTextDecorative Loot Drop detail.
Legendary labelLEGENDARYTextDecorative Loot Drop detail.
TitleEmptyText
Title formatEmptyTextOptional: {label}, {current}, {goal}, {remaining}, {percent}, {next}, {last}, {top}, {eta}.
Raise goal by00 to 10000000
Goal chainEmptyTextSteps as "Follower Goal:100;Sub Goal:150".
Detail textEmptyTextOptional extra line, for example: {remaining} to go.
DeadlineEmptyText

Appearance

SettingDefaultValuesNotes
Background plateOnOn or offUsed by Loot Drop.
Title fontLook defaultLook default, Baloo 2, Nunito, Quicksand, Inter, Geist, Sora, Bricolage Grotesque and 7 moreUsed by Loot Drop.
Value fontLook defaultLook default, Baloo 2, Nunito, Quicksand, Inter, Geist, Sora, Bricolage Grotesque and 7 moreUsed by Loot Drop.
Detail fontLook defaultLook default, Baloo 2, Nunito, Quicksand, Inter, Geist, Sora, Bricolage Grotesque and 7 moreUsed by Loot Drop.
Compact stripOffOn or off
ShowLabel, bar and valueLabel, bar and value, Bar and value, Bar only, Value only
Vertical barOffOn or off
Bar height (px)400200 to 900Only used by the vertical bar.
Scale (%)3216 to 64
Bar width (px)560240 to 1200
Number style12,34512,345, 12.3k, Currency
Currency codeEURTextOnly used by the currency number style.
Accent colorLook defaultAny color
Label iconNo iconMatch the goal type, Heart (follows), Star (subs), Diamond (bits), Coin (tips), Medal (points), Flag (custom), No icon
CelebrationFull (text + particles)Full (text + particles), Subtle (flash only), Off
Celebrate how oftenOnce per streamOnce per stream, Every timeOnly used when celebrations are on.
Show on activity onlyOffOn or off
Stay visible (s)82 to 120Only used with "Show on activity only".

Milestones

SettingDefaultValuesNotes
Milestone 1EmptyText
Milestone 1 at (%)251 to 100Name the milestone first.
Milestone 2EmptyText
Milestone 2 at (%)501 to 100Name the milestone first.
Milestone 3EmptyText
Milestone 3 at (%)751 to 100Name the milestone first.
Milestone 4EmptyText
Milestone 4 at (%)1001 to 100Name the milestone first.

Live data

SettingDefaultValuesNotes
Twitch live totalsNot connectedConnect TwitchOnly used by follower and sub goals.
Ko-fi donationsNot connectedConnect Ko-fiOnly used by the Donation goal (Ko-fi).

Chat commands

SettingDefaultValuesNotes
Command wordgoalText
Chat channelsAll connected channelsYour connected Twitch, Kick and YouTube channels
Who can use commandsBroadcaster, ModeratorsBroadcaster, Moderators, VIPs, Subscribers, Everyone

Sound

SettingDefaultValuesNotes
SoundEmptyText
Sound volume700 to 100Upload or paste a sound first.
Sound on milestonesOffOn or offUpload or paste a sound first.

Was this page helpful?