Channel Points Guide
Map Twitch channel point rewards to Tangia overlay actions, set pricing and cooldowns, add conditional rules.
How the mapping works
Tangia listens to Twitch's channel:read:redemptions EventSub. When a viewer redeems a channel point reward, Tangia matches the reward name to your configured mappings and fires the corresponding overlay action.
You create the rewards in Twitch's creator dashboard first, then tell Tangia which reward name triggers which overlay.
Create a reward in Twitch first
In Twitch Creator Dashboard → Viewer Rewards → Channel Points → Manage Rewards:
- Click Add Custom Reward
- Name it something specific: "Play a Sound", "Hydrate Challenge", "Skip Song"
- Set the point cost, cooldown, and user limit in Twitch
- Enable the reward
Tip: set the Twitch-side cooldown to match your Tangia cooldown. Double-gating prevents queue buildup if viewers spam a reward.
Add a mapping in Tangia
In your Tangia dashboard → Channel Points → Add Reward Mapping:
| Field | What to enter |
|---|---|
| Reward Name | Exact name from Twitch (e.g. "Play a Sound") |
| Tangia Action | Pick from overlay type list |
| Cooldown | Seconds between fires (separate from Twitch cooldown) |
| Max Queue Depth | How many pending can stack (1–10) |
| Priority | Normal / High — High skips the queue |
Conditional rules (Creator / Studio)
Add conditions to any mapping to control when it fires:
- Sub-only: Only fire for subscribers (T1, T2, T3 — configurable)
- Time of stream: Only fire after X hours into a stream (e.g. "Boss fight mode begins at hour 3")
- Queue depth gate: Pause the mapping if the queue is deeper than N items (prevents backlog during raids)
- Manual override: Streamer can pause/resume any individual mapping from the dock panel during stream
Know the limits: Twitch API rate caps
Tangia's channel point queue is downstream of Twitch's EventSub delivery. A few things you can't configure around:
- Twitch throttles rapid-fire redemptions — if 50 viewers redeem a reward in 10 seconds, Twitch batches or delays delivery. Tangia processes whatever arrives, in arrival order.
- EventSub has a per-subscription message limit — Twitch does not publish exact thresholds, but sustained high-volume channels can hit delivery delays during peak activity.
- Tangia can't refund channel points — point refunds require a streamer to manually approve in Twitch's Creator Dashboard. Tangia can flag a redemption as "skip" but the point refund itself is a Twitch action.
Practical fix: set Twitch-side cooldowns on high-demand rewards. A 30-second Twitch cooldown reduces burst volume before it reaches Tangia's queue.
Test your setup
Before going live, use the Test Fire button in Tangia dashboard next to each mapping. This fires the overlay action as if a real redemption just happened — lets you check animation, timing, and queue behavior without spending channel points.