Stream Goals

Created 4 Mar 2026·Updated 31 Jul 2026

Open Goals in TipLink

Stream Goals let you set a target, like raising $500 for a charity or getting 100 subscribers, and track your progress live. You can display goal progress on your stream overlay so viewers can watch it climb in real time.

---

What Is a Goal?

A Goal is a named target with a current progress value and a maximum target value.

Example: Goal title: "New PC Fund", Target: 500, Current: 127 = 25.4% complete.

Goals can be:

• Active - Counting towards the target, visible on your overlay.
• Inactive - Paused or archived, not displayed.

How goals update

Goal progress is updated manually, or automatically by alert actions. For example, you can create an alert that adds the donation amount to your goal every time you receive a tip.

---

Creating a Goal

1. Click Goals in the left sidebar.
2. Click Create New Goal in the top-right corner.
3. Fill in the fields:
   • Title - A name for the goal (e.g. "Charity Fundraiser").
   • Target - The total amount needed (e.g. 500).
   • Starting Progress - Optional. Set this if you're already partway there (e.g. 127).
   • End Date - Optional. Set a deadline for the goal.
4. Click Create.

Your new goal will appear in the list on the Goals page.

---

Managing Goals

Each goal in the list has the following controls:

Button	What it does
Active toggle	Enable or disable the goal. Inactive goals are dimmed and won't appear on your overlay.
Reset	Set the current progress back to zero.
Delete	Permanently remove the goal.

Editing a Goal

To change a goal's title, target, or dates, click the goal in the list to open its edit view.

---

Displaying a Goal on Your Stream

There are two widgets for showing goals on an overlay canvas.

Widget	What it shows
Stream Goal	One goal, as a single progress bar card.
Goals (Progression)	Several goals at once, in a compact stacked panel.

To add one:

1. Go to Overlays in the sidebar.
2. Open an existing canvas, or create a new one.
3. Click Open Widget Editor.
4. Add the widget you want, then click the gear icon next to it to choose which goal or goals it shows.
5. Resize and position the widget on the canvas.

The widget shows the goal title, progress bar, and current and target values, updating live as progress changes. See Stream Overlays for every appearance option.

Showing a goal inside other text

You can also drop a goal value into a Text widget or into any action message using {{ goal.Title }} for "current/target", or {{ goal.Title.current }} for just the number. Other fields are target, title, active, remaining and percent.

---

Updating Goal Progress Automatically

You can connect a goal to an alert so that every matching event automatically increases the progress.

1. Open or create an Alert (e.g. one that fires on any donation).
2. Add the Goal: Increment action.
3. Select the goal to add progress to.
4. Set the Amount - this can be a fixed number or a value from the event, for example {{ value }} to add the exact donation amount.
5. Save the alert.

Now every time that alert fires, the goal's progress increases automatically.

---

Tips

• You can have multiple goals at the same time, but only active ones appear on your overlay.
• Use the Reset button at the start of each stream to restart your goal.
• Set an End Date to automatically deactivate a goal after your campaign ends.
• Goals persist between TipLink restarts.

---

Goal Completion & Overflow Modes

When a goal reaches 100% or more, TipLink fires a Goal Completed event. You can use this to trigger alerts - for example, playing a sound, showing a congratulations overlay, or sending a Discord notification.

Overflow Behaviour

When you create or edit a goal, you can choose what happens when progress exceeds the target:

Mode	What it does
Exceed	Progress continues accumulating above 100%. The bar fills and stays at full.
Loop (Reset)	Progress resets to zero (or the remainder) every time the target is reached, and the Goal Completed event fires again for each loop.

Example - Loop mode: Goal target is $100. A viewer tips $250. The goal completes at $100, $200, and $250 - firing Goal Completed twice (two full completions), and leaving $50 remaining on the third cycle.

Completion Count

A Goal Completed event carries {{ totalCompletions }}, which is how many times the goal completed from that one increment. A single large tip in Loop mode can complete the goal several times over.

This is the value the Minimum Completions and Maximum Completions conditions check, so you can have an alert that only fires on a tip big enough to complete the goal more than once.

Each of those completions also carries {{ completionIndex }}, telling you which one it is.

To stop a very large tip firing a flood of events, TipLink caps how many completions one increment can produce. Change Max Completions Per Increment on the Settings page if you need a different limit. The default is 50.

---

Triggering an Alert from a Goal

Goals can trigger alerts in two ways.

Event	When it fires
Goal Completed	The goal reaches 100% of its target.
Goal Milestone Reached	The goal passes a progress percentage you choose, for example 25%, 50% or 75%.

To set one up:

1. Open Alerts in the sidebar.

2. Create a new alert (or open an existing one).

3. Under Platforms, choose TipLink Goals.

4. Under Valid Events, choose Goal Completed or Goal Milestone Reached.

5. Set the conditions:

   For Goal Completed

   • Specific Goals - leave empty to fire for any goal, or pick particular ones.
   • Minimum Completions - how many completions in a single increment are needed. 1 means any completion.
   • Maximum Completions - optional upper limit.

   For Goal Milestone Reached

   • Specific Goals - leave empty to fire for any goal.
   • Minimum Progress % - the percentage the goal must reach. 100 means 100%.
   • Maximum Progress % - optional upper limit.

6. Add your actions (overlay message, Discord notification, sound effect, etc.).

7. Save the alert.

Halfway hype

Set up a Goal Milestone alert with a minimum of 50 and a maximum of 99 to celebrate the halfway point without also firing when the goal finishes.

Available Event Data

Goal Completed

Placeholder	What it contains
{{ goalTitle }}	The name of the goal that completed
{{ current }}	The progress value when the event fired
{{ target }}	The goal's target value
{{ completionIndex }}	Which completion this is, when one increment completed the goal several times
{{ totalCompletions }}	How many completions that single increment produced
{{ overflowBehavior }}	Either exceed or reset

Goal Milestone Reached

Placeholder	What it contains
{{ goalTitle }}	The name of the goal
{{ current }}	The progress value when the event fired
{{ target }}	The goal's target value
{{ progressPct }}	The percentage reached
{{ completionCount }}	How many completions that increment produced
{{ overflowBehavior }}	Either exceed or reset

Example overlay message:

🎉 Goal reached! {{ goalTitle }} hit {{ target }}! Thank you all!