Before a bot or overlay may work with your channel, Twitch shows a list: “This app would like to …”. Most people click Authorize without reading. Yet that list says exactly what the tool may do on your behalf. Here you learn to read it.
What a scope is
A tool never gets your password from Twitch but a token: a key that only unlocks certain things. Which things is set by the scopes. Each scope is a single permission, such as “read chat” or “see subscribers”. Whatever is not granted, the tool cannot do, however much it would like to.
Scopes follow a pattern: first the area (channel, moderator, user, chat …), then usually read for reading or manage for managing. That one word alone already says a lot about the risk.
The most important scopes for streamers
| Scope | Allows | Typical for |
|---|---|---|
chat:read, chat:edit | Read chat and send messages | Chat bots |
moderator:read:chatters | See the list of people in chat | Watch time, giveaways |
moderator:read:followers | See a channel’s followers | Follower checks, alerts |
channel:read:subscriptions | See subscribers and their tier | Sub bonuses, alerts |
bits:read | See Bits leaderboards and events | Alerts, thank-you messages |
channel:read:redemptions | See channel point rewards and redemptions | Request lists, overlays |
channel:manage:redemptions | Create and edit rewards, fulfil or refund redemptions | Tools that manage rewards themselves |
channel:manage:moderators | Add and remove moderators | Bot makes itself a mod |
channel:manage:broadcast | Change title, category and other broadcast settings | Title automation |
user:read:email | See the account’s e-mail address | Customer account with the provider |
Reading is harmless, managing is not
A read scope lets a tool watch. At worst it learns things it does not need to know. A manage scope lets it act: add moderators, change the title, delete rewards. If such a token falls into the wrong hands, someone can do visible things in your channel.
For every manage scope, ask yourself: does the tool really need this for the feature I want to use? An overlay that only shows alerts has nothing to manage.
A trustworthy tool only asks for what it uses, and explains why. A login that only identifies viewers needs no scopes at all: our viewer login requests not a single one.
Example: changing the title without asking for the title scope
A 24/7 stream should show in its title which video is playing. The direct route would be channel:manage:broadcast, and with it the right to change the category and other broadcast settings as well. We deliberately do not request this scope. Instead our bot announces the video in chat, and StreamElements, which is connected to the channel anyway, sets the title from it. How that works is described in the guide on StreamElements user levels.
The pattern carries over: if a tool you have already connected can take on a task, a second tool does not need the same powerful permission.
How long access lasts
- Access tokens expire. Tools renew them with a refresh token, without you having to log in again.
- Refresh tokens become invalid when you change your Twitch password or disconnect the app. For apps without their own server (public clients) they also expire after 30 days.
- Tools must validate tokens. Twitch requires apps to validate their tokens at startup and then every hour. That way they notice quickly when you have revoked access.
- Tools should hand tokens back. Twitch offers a revocation endpoint and recommends revoking a token as soon as it is no longer needed.
Revoking access
In your Twitch settings under Connections you find every app you have given access to. Disconnect revokes it; the app’s refresh token becomes invalid. Do this for every tool you no longer use. If an app you do not recognise appears there, disconnect it and change your password to be safe.
Warning signs
- A tool asks for your Twitch password. Trustworthy tools always send you to Twitch’s own login page.
- You are asked to paste a token into chat or a form without it being clear where it is stored.
- The list is much longer than the feature. A song request bot with moderator and title rights is not a good sign.
- No explanation. Whoever does not say why they need a scope usually has not thought about it.
Checklist before you authorize
- Am I logged in to the right Twitch account in this browser?
- Does every scope match a feature I actually use?
- Which
managescopes are included, and do I need them? - Does the provider explain what it uses the rights for and how it stores tokens?
- Disconnected old apps under Connections?