User: Modify Points
Published 31 Jul 2026
Change a viewer's points balance when an alert fires. Use this for awards that the automatic Points Settings cannot express, such as a bigger bonus for a higher subscription tier.
Quick Start
- Create or edit an alert.
- Add the User: Modify Points action. It is under Users & Goals.
- Leave User on User from Event (auto-detect).
- Choose an Operation and an Amount.
- Save and test.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| User | Whose balance to change. See below. | User from Event |
| Select User | Which viewer, when User is set to Specific User. | - |
| Operation | Add, Subtract, Set or Reset. | Add Points |
| Amount | How many points. Accepts placeholders such as {{ value }}. Hidden for Reset. | 1 |
User
| Option | What it does |
|---|---|
| User from Event (auto-detect) | Uses whoever triggered the alert. This is what you want almost every time. |
| Specific User | Always targets one viewer you pick from a list. |
Operations
| Operation | What it does |
|---|---|
| Add Points | Increases the balance. |
| Subtract Points | Decreases it. Balances never drop below zero. |
| Set Points | Replaces the balance with an exact number. |
| Reset to 0 | Clears the balance. |
Common Uses
Bonus for raiding
- Trigger: Received a Raid
- Operation: Add Points
- Amount:
{{ value }}
One point per viewer brought along.
Tier-based subscriber bonus
Make one alert per tier, each filtered to a single Valid Subscription Tier, and give each a different amount.
Charging for a command
- Trigger: Chat Message, Match Contains
!vote - Action 1: User: Modify Points, Subtract Points,
50 - Action 2: whatever the vote should do
Unlike a redemption, this action does not check whether the viewer can afford it. Subtracting more than someone has floors them at zero, and the rest of the alert still runs.
If you need "only if they can pay", use a redemption instead.
Punishing a command
- Trigger: Chat Message matching a banned phrase
- Operation: Reset to 0
Reading the Result
Later actions in the same alert can show the new balance with {{ user_points }}:
@{{ username }} you now have {{ user_points }} points
{{ user_points }} is captured when the event arrives. To show the balance after this action has run, make sure actions run one at a time, and check the value in a test before going live.
Troubleshooting
The action reports an error
TipLink could not work out who to award. This happens with anonymous events and events that carry no username. Open the event on the Activity page to see what it contained.
Points went to the wrong person
Two viewers on the same platform sharing a display name can be confused when the platform sends no user ID. Expand the viewer's row on the Users page and check whether they have a Platform User ID.
Nothing happened at all
The viewer may have no record yet. Chat-only viewers are only created when Track Chat-Only Viewers is on in Settings, and when Chat Message is not excluded for that account.
Related
- Points & Viewers - how balances work.
- Earning Points - automatic awards that need no alert.
- Redemptions - letting viewers spend points.