everything's up and runningsee status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

Team & permissions

The Team page (/settings/team) lets you grant moderators and co-administrators access to your dashboard without sharing your broadcaster account. Each member is invited with their own Twitch login, assigned a role, and granted exactly the dashboard areas that role is permitted to manage.

Only the workspace Owner has access to this page.

Roles

RoleDescription
OwnerThe Twitch broadcaster to whom the workspace belongs. Always holds every permission. Each workspace has exactly one Owner; the role cannot be reassigned or removed.
AdminA trusted co-administrator, such as a co-streamer or channel manager. Holds every permission by default; individual permissions can be revoked.
ModeratorA channel moderator. By default permitted to manage chat content (commands, counters, events, quotes, timers, alerts, media commands, media library, Auto-Mod, the Pro overview). Not permitted by default to manage the Twitch, Spotify, YouTube Music, or StreamElements connections; the Owner can grant these explicitly.

Higher roles do not automatically inherit lower-role permissions. Each (role, capability) pair is configured independently in the permission matrix.

Adding a member

  1. Open /settings/team and click Add member.
  2. Begin typing the Twitch login (at least two characters). The field is an autocomplete: streamion.bot queries Twitch and suggests up to six matches, showing each candidate's avatar, display name, login, language, and a LIVE badge with the current category if they are currently streaming. Members already in your workspace are greyed out and marked already a member.
  3. Pick the matching suggestion, or finish typing the full login manually if it does not appear in the suggestions.
  4. Choose Admin or Moderator.
  5. Save. streamion.bot looks the login up on Twitch; if the user has never signed in to streamion.bot before, an account is created for them automatically.

The new member must log in to streamion.bot at least once for the role to take effect — they sign in with their own Twitch account just like you did.

Changing a role

Select the new role from the dropdown in the Members table. The Owner row is fixed; ownership cannot be transferred through this interface. Role changes take effect on the affected member's next login. A banner at the top of the Team page reminds you of this.

Removing a member

Click the trash icon next to the member's row and confirm. Access is revoked on the member's next streamion.bot request. The Twitch account itself is not affected — only the membership in your workspace is removed.

Permission matrix

The lower table on the Team page allows you to toggle each capability per role. The Owner has all permissions implicitly and is therefore not shown in the matrix.

Permission keyWhat unlocks for the roleDefault for AdminDefault for Moderator
commands.manageThe Commands sidebar item and /commands page (built-in defaults & custom commands).OnOn
counters.manageThe Counters sidebar item and /counters page.OnOn
events.manageThe Event Responses sidebar item and /events page.OnOn
quotes.manageThe Quotes sidebar item and /quotes page.OnOn
timers.manageThe Timers sidebar item and /timers page.OnOn
overlays.manageThe Tools → Alerts sidebar item and /alerts page (alert-overlay browser source and per-event configuration), plus the Settings → Text-to-Speech page (/settings/tts).OnOn
automod.manageThe Settings → Auto-Mod sidebar item and /automod page (filter rules, exemptions, bot-raid defense).OnOn
media.manageThe Settings → Media Library sidebar item and /settings/media page (upload and manage images, sounds, videos).OnOn
media-commands.manageThe Tools → Media Commands sidebar item and /media-commands page (chat-triggered sound and video clips).OnOn
pro.manageThe streamion.bot Pro sidebar item and /pro page (Pro feature catalogue and overview).OnOn
channel.manageSettings → Channel (/channel) — the Twitch connection itself.OnOff
spotify.manageThe Spotify sidebar group (Playlists, SR Blacklist).OnOff
youtubemusic.manageThe YouTube Music sidebar group (Playlists, SR Blacklist).OnOff
donations.manageSettings → Donations (/settings/streamelements).OnOff

The Settings → Music page (/settings/music) — where music-provider connections are managed — is gated by role, not by an individual permission switch: it requires the Admin role (or higher) regardless of how spotify.manage / youtubemusic.manage are set. Those two permissions only govern the operational sub-pages (Playlists, SR Blacklist).

The four integration permissions default to off for Moderators by design. Connecting or disconnecting Twitch, Spotify, YouTube Music, or StreamElements affects the entire workspace, and these actions are typically reserved for the broadcaster or for administrators.

A toggle controls both read and write access. When a permission is disabled, the corresponding sidebar entry disappears from the member's view on their next page load.

When toggle changes apply

Changes are saved immediately, but the member's current login session keeps the previous permissions until they next sign in or until the session expires. If a permission change does not seem to take effect, the member is most likely still using a session that started before the change. A banner above the matrix on the Team page is a reminder of this.

Recommendation: keep integration permissions with the Owner

Even when you fully trust your administrators, it is generally advisable to leave channel.manage, spotify.manage, youtubemusic.manage, and donations.manage enabled only for the Owner. These permissions control the connections that supply the workspace with data, and an inadvertent disconnect during a live stream is a significant disruption.