Skip to main content

Stream Goals

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:

ButtonWhat it does
Active toggleEnable or disable the goal. Inactive goals are dimmed and won't appear on your overlay.
ResetSet the current progress back to zero.
DeletePermanently 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​

Goals can be shown on your stream overlay using a Goal Widget inside an Overlay Canvas.

  1. Go to Overlays in the sidebar.
  2. Open an existing canvas, or create a new one.
  3. Click Open Widget Editor.
  4. Add a Goal Widget and select the goal to display.
  5. Resize and position the widget on the canvas.
  6. Click OK to save.

The widget will automatically show the goal title, progress bar, and current/target values, updating live as progress changes.

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 a "Update Goal" action.
  3. Select the goal to update.
  4. Set the amount to add — this can be a fixed number or a dynamic value from the event (e.g. {{ value }} to add the exact donation amount).
  5. Save the alert.

Now every time that alert fires, the goal's progress will increase 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:

ModeWhat it does
ExceedProgress 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​

The completionCount field in the Goal Completed event tells you how many times the goal completed in a single event (for example, a single large tip that exceeds the target multiple times in Loop mode). You can filter your alert trigger to only fire when this count meets a minimum value.

Triggering an Alert on Goal Completion​

  1. Open Alerts in the sidebar.
  2. Create a new alert (or open an existing one).
  3. In the Trigger section, set:
    • Platform: TipLink Goals
    • Event: Goal Completed
  4. Optionally filter to a specific goal, or set a minimum/maximum completion count.
  5. Add your actions (overlay message, Discord notification, sound effect, etc.).
  6. Save the alert.

Available Event Data in Goal Completed Alerts​

FieldDescription
goalTitleThe name of the goal that was completed
currentProgressThe progress value at the time the event fired
targetValueThe goal's target value
completionCountHow many times the goal completed in this single increment
overflowBehaviorEither exceed or reset (the mode the goal is using)

Example overlay message:

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