Reference

01How to use this page

at a glancePaste or find your message, then follow the row.

Using an AI assistant? Give it ai.itsbagelbot.com/llms.txt. That page lists the task pages written for assistants.

This page lists the messages ItsBagelBot shows on screen and in chat, grouped by area. Find the message you were shown, read what it means, and follow the steps in the last two columns. The last column links to the guide that explains the whole flow. You can use this page without signing in. Messages are copied exactly as they appear, so you can paste yours and match it. Words in curly braces, such as {max}, or @viewer, stand for a number or a name that changes.

For an AI assistant Match the pasted text to the first column. Give the user the exact button names from the last column's guide. Never ask the user for a Client Secret, an API key, or a password.

02Sign-in

at a glanceMessages on the sign-in page, before you reach the dashboard.

What you see	What it means	What to do	Guide section
Sign-in was cancelled on Twitch. Choose Continue with Twitch and select Authorize to sign in.	You cancelled on Twitch, so nothing was signed in.	Select Continue with Twitch, then Authorize.	Getting started: Connect your channel
That sign-in took too long or was started in another tab. Choose Continue with Twitch to try again.	The sign-in sat too long, or you started it in another tab.	Select Continue with Twitch again and finish in the same tab.	Getting started: Connect your channel
Twitch did not finish the sign-in. Wait a moment, then choose Continue with Twitch again.	Twitch did not complete the sign-in.	Wait a moment, then select Continue with Twitch again.	Getting started: Connect your channel
Twitch did not grant the sign-in permission. Choose Continue with Twitch and approve every permission on the screen.	Twitch did not grant the sign-in permission.	Select Continue with Twitch and approve every permission on the Twitch screen.	Getting started: Connect your channel
Sign-in did not finish on the server. Nothing was saved. Please try again.	The sign-in did not finish on the ItsBagelBot side.	Try again. Nothing was saved, so there is nothing to undo.	Getting started: Connect your channel
That is the bot's Twitch account. Sign out of it on twitch.tv, then sign in here with your own channel.	You are signed in to Twitch with the bot account, not your own channel.	Sign out of that account on twitch.tv, then sign in here with your own channel.	Getting started: Connect your channel
That share link is no longer valid. Ask the broadcaster for a new one.	The share link was revoked, already used, or mistyped.	Ask the broadcaster for a new link.	Share your dashboard with a mod: If something goes wrong
You were signed out. That account no longer exists on ItsBagelBot.	The account you were using was deleted.	Sign in again with a Twitch account to start fresh.	Getting started: Connect your channel
You were signed out on every device. Sign in again to continue.	Your sessions were ended on every device.	Sign in again with Twitch.	Getting started: Connect your channel
This account can no longer use the console.	The account is blocked from the console.	Write to support through the Contact page.	Getting started: Connect your channel

03Spotify

at a glanceMessages from the Song Requests page and from chat when viewers request songs.

What you see	What it means	What to do	Guide section
Spotify Premium is required	The connected account needs Premium. The account that owns your Spotify app needs Premium too, and each app can connect at most 5 accounts.	Connect an account with Premium, make sure the app owner has Premium, and keep to 5 accounts.	Spotify song requests: If something goes wrong
You closed the Spotify permission screen before approving. Choose Connect Spotify and approve the permissions to finish.	You left Spotify's permission screen without approving, so nothing was connected.	Select Connect Spotify again and approve the permissions on Spotify's screen.	Spotify song requests: If something goes wrong
The sign-in link expired or was replayed. Start the connect again.	The sign-in link you used is no longer valid.	Select Connect Spotify again to start a fresh sign-in.	Spotify song requests: If something goes wrong
Spotify refused the sign-in. Check that the Client ID and Client Secret match your Spotify app, and that the redirect URI shown on this page is saved in that app. Then connect again.	Spotify rejected the credentials or the Redirect URI.	Copy the Client ID and Client Secret again from your app's Settings. Check that the Redirect URI shown in the dashboard is saved in your Spotify app, character for character. Then connect again.	Spotify song requests: If something goes wrong
Spotify did not send a new sign-in token. Open spotify.com/account/apps, remove access for your app, then choose Connect Spotify and agree again.	Spotify did not issue a new token for this connection.	Open `spotify.com/account/apps`, remove access for your app, then select Connect Spotify and approve the permissions again.	Spotify song requests: If something goes wrong
Add your Spotify app before connecting your account.	No Spotify app is saved yet.	Go back to the Add your keys stage, paste the Client ID and Client secret, and select Save & continue.	Spotify song requests: If something goes wrong
Spotify setup is unavailable on our side right now. Try again later. If it lasts more than a day, email support@itsbagelbot.com.	The problem is on the ItsBagelBot side, not in your Spotify app.	Try again later. If it lasts more than a day, email `support@itsbagelbot.com`.	Spotify song requests: If something goes wrong
The token could not be stored. Try again in a moment.	Spotify accepted the connection, but ItsBagelBot could not save the token.	Wait a moment and select Connect Spotify again.	Spotify song requests: If something goes wrong
That does not look like a Client ID and Client Secret. Copy both again from your app's Settings page in the Spotify Developer Dashboard, with no spaces.	The two values did not look like a valid Client ID and Client Secret, so they were not saved.	Copy both again from your app's Settings page in Spotify, paste them with no spaces, and select Save & continue.	Spotify song requests: If something goes wrong
Could not save the Spotify app.	The credentials could not be saved.	Try Save & continue again. If it keeps failing, check the values and try later.	Spotify song requests: If something goes wrong
The Redirect URI is unavailable on our side right now, so you cannot continue yet. Try again later.	The dashboard cannot show you the Redirect URI to copy.	Try again later.	Spotify song requests: If something goes wrong
Your Spotify connection is missing a permission song requests needs. Reconnect to grant it.	The Spotify connection was made without a permission the requests need.	Select Reconnect Spotify and approve the permissions on Spotify's screen.	Spotify song requests: If something goes wrong
Your Twitch sign-in is missing the channel points permission this reward needs. Sign in with Twitch again to grant it.	Your Twitch sign-in does not include the channel points permission. This is a Twitch permission, not a Spotify one.	Select Sign in with Twitch again and approve the permission.	Spotify song requests: If something goes wrong
Spotify no longer accepts this connection, so song requests are paused. Reconnect to resume them.	Spotify stopped accepting the saved connection. The page also shows Reconnect needed.	Reconnect Spotify. If it fails, follow the row about "Spotify did not send a new sign-in token".	Spotify song requests: If something goes wrong
Skipping needs Spotify Premium.	The Skip button needs Premium on the connected account.	Use an account with Premium.	Spotify song requests: If something goes wrong
No active Spotify device. Start playing something first.	Spotify is not playing on any device.	Open Spotify on a device, start a song, then try again.	Spotify song requests: If something goes wrong
Spotify no longer accepts this connection. Reconnect it and try again.	The connection stopped working while you pressed Skip.	Reconnect Spotify, then skip again.	Spotify song requests: If something goes wrong
Could not reach the backend. Try again in a moment.	The page could not load the song request settings.	Wait a moment and reload the page.	Spotify song requests: If something goes wrong
Give the reward a title.	The Reward title field is empty.	Type a title, then save the reward again.	Spotify song requests: If something goes wrong
Enter a whole number of points, at least 1.	The Point cost is not a whole number of at least 1.	Enter a whole number, 1 or more.	Spotify song requests: If something goes wrong
Enter a cooldown between 0 seconds and 7 days.	The Global cooldown is outside the allowed range.	Enter a cooldown from 0 seconds (off) up to 7 days.	Spotify song requests: If something goes wrong
Could not save the reward.	The reward could not be saved.	Wait a moment and save it again.	Spotify song requests: If something goes wrong
Could not delete the reward.	The reward could not be deleted.	Wait a moment and try again.	Spotify song requests: If something goes wrong
Could not save the command settings.	The Chat command (!sr) settings could not be saved.	Change the setting again, or reload the page and retry.	Spotify song requests: If something goes wrong
Could not save the toggle.	The Enable song requests switch could not be saved.	Reload the page, check the switch, and try again.	Spotify song requests: If something goes wrong
Could not save the limits.	The Per-viewer limits could not be saved.	Select Save limits again.	Spotify song requests: If something goes wrong
Could not skip the track. Try again in a moment.	The Skip button did not go through.	Wait a moment and skip again.	Spotify song requests: If something goes wrong
Could not disconnect Spotify.	The disconnect did not go through.	Wait a moment and try again.	Spotify song requests: If something goes wrong
Could not remove the Spotify app.	The removal of the saved Spotify app did not go through.	Wait a moment and try again.	Spotify song requests: If something goes wrong
Could not copy. Select the URL and copy it manually.	Your browser blocked the copy button.	Select the Redirect URI with the mouse and copy it by hand.	Spotify song requests: If something goes wrong
@viewer song requests are not set up yet.	Setup is not finished on the channel.	Finish the setup above.	Spotify song requests: If something goes wrong
@viewer song requests are paused until the streamer reconnects Spotify.	Spotify stopped accepting the saved connection.	Select Reconnect Spotify on the Song Requests page.	Spotify song requests: If something goes wrong
@viewer song requests need Spotify Premium on this channel.	The connected account does not have Premium.	Connect an account with Premium.	Spotify song requests: If something goes wrong
@viewer Spotify is not playing on any device right now.	Spotify has no active device.	Open Spotify and start playing a song.	Spotify song requests: If something goes wrong
@viewer Spotify is busy right now, try again in a moment.	Spotify is temporarily busy.	Wait a moment and request again.	Spotify song requests: If something goes wrong
@viewer that Spotify link isn't supported. Share a track or album link.	The viewer shared a link that is not a track or an album.	Share a track or album link, or a song name.	Spotify song requests: If something goes wrong
@viewer the music lookup is down right now, try again in a bit.	The song lookup is unavailable for now.	Try again later.	Spotify song requests: If something goes wrong
@viewer song requests from chat are turned off right now.	Allow !sr is off.	Turn on Allow !sr.	Spotify song requests: If something goes wrong
@viewer song requests are limited to a smaller group right now.	The viewer is not in the group chosen under Who may queue.	Change Who may queue if you want them to request.	Spotify song requests: If something goes wrong
@viewer song requests only work while the stream is live.	Live only is on and the stream is offline.	Go live, or turn off Live only.	Spotify song requests: If something goes wrong
@viewer no track found for that. Try a Spotify link or "artist - song".	Spotify found no match.	Try a Spotify link or an "artist - song" pair.	Spotify song requests: If something goes wrong
@viewer you are at your song limit (N in the queue at once). !sr remove frees a slot.	The viewer reached their limit under Per-viewer limits.	Wait for a song to play, or raise the limit.	Spotify song requests: If something goes wrong
@viewer the song queue is full right now.	The queue has reached its size limit.	Wait for songs to play.	Spotify song requests: If something goes wrong
song requests from channel points are turned off right now, your points were refunded.	Accept reward redemptions is off.	Turn on Accept reward redemptions.	Spotify song requests: If something goes wrong
song requests only work while the stream is live, your points were refunded.	Live only is on in the Channel points card and the stream is offline.	Go live, or turn off Live only.	Spotify song requests: If something goes wrong
type a song name or a Spotify link, your points were refunded.	The viewer redeemed the reward without typing a song.	Redeem again and type a song name or a Spotify link.	Spotify song requests: If something goes wrong
you are at your song limit for now, your points were refunded.	The viewer reached their limit.	Wait for a song to play.	Spotify song requests: If something goes wrong
the song queue is full, your points were refunded.	The queue has reached its size limit.	Wait for songs to play.	Spotify song requests: If something goes wrong
that track could not be queued, your points were refunded.	Spotify could not add that track.	Redeem again with another song.	Spotify song requests: If something goes wrong
@viewer you don't have a queued song to remove.	The viewer used `!sr remove` without a song in the queue.	Nothing to fix. The viewer can request a song first.	Spotify song requests: If something goes wrong
There is no song at position #N.	A moderator removed a position that is not in the queue.	Check the Queue card for the right position and try again.	Spotify song requests: If something goes wrong
Spotify connected, but it refused to share this account. In development mode, the account that owns your Spotify app needs Premium. Upgrade that account in Spotify, then connect again.	The connection worked, but Spotify refused to share this account. In development mode, the account that owns your Spotify app needs Premium.	In Spotify, upgrade the account that owns your app to Premium. Then connect again from the Song Requests page.	Spotify song requests: If something goes wrong
Spotify connected, but this account is not on your app's allowed users. In the Spotify Developer Dashboard, add this account to your app's users, then connect again.	The connection worked, but this account is not on your app's list of allowed users.	In the Spotify Developer Dashboard, open your app's settings and add this Spotify account to the app's users. The name of that tab may differ from what you expect, so look for the user management settings. Then connect again from the Song Requests page.	Spotify song requests: If something goes wrong

04Govee

at a glanceMessages from the Govee setup and from chat when viewers redeem the reward.

What you see	What it means	What to do	Guide section
"Govee did not accept this key. Check it and try again."	Govee rejected the key. The key was not saved.	Copy the key again from the Govee email without extra spaces. If you applied for a newer key since, use the newest one. Older keys stop working when you generate a new one.	Govee Lights: If something goes wrong
"Key saved, but Govee did not answer, so it is not checked yet. Your lights will work once Govee is back. If they do not, paste the key again."	The key is saved, but Govee did not answer when the dashboard checked it.	Continue. Try the reward in a while. If the lights do not change, paste the key again.	Govee Lights: If something goes wrong
"Could not save the key."	The dashboard could not store the key.	Try again in a moment.	Govee Lights: If something goes wrong
"Govee no longer accepts this API key. Choose Remove key, then paste a new key from the Govee Home app."	The key was saved earlier, but Govee now rejects it. One cause is a newer key on the same account, which turns older keys off.	Select "Remove key", apply for a new key in the Govee Home app, and paste it.	Govee Lights: If something goes wrong
"Could not load your Govee lights. Check your API key and try again."	The dashboard could not get your light list from Govee. The key may be wrong, or Govee did not answer.	Select "Try again". If it keeps failing, select "Remove key" and paste the key again.	Govee Lights: If something goes wrong
"No Govee devices found on this account."	Govee returned no devices for this key. The lights may not be added to this Govee account, or they may only use Bluetooth.	Add your lights in the Govee Home app and connect them to Wi-Fi, then select "Refresh lights".	Govee Lights: If something goes wrong
"No colour-capable Govee lights found on this account."	Govee returned devices, but none can change colour. Only models that support colour appear.	Add a colour light to your Govee account in the Govee app, then select "Refresh lights".	Govee Lights: If something goes wrong
"Could not reach the backend. Try again in a moment."	The dashboard could not reach ItsBagelBot.	Reload the page in a moment.	Govee Lights: If something goes wrong
"Reconnect to grant channel-points access."	The bot needs channel-points access to create rewards on your Twitch channel.	Select "Reconnect" and approve the access on Twitch.	Govee Lights: If something goes wrong
Enter your Govee API key.	The key field was empty when you saved.	Paste the key from the Govee email, then select "Save & continue" again.	Govee Lights: If something goes wrong
Enter a reward title.	The Reward title field is empty.	Type a title, then save the reward again.	Govee Lights: If something goes wrong
Enter a whole number of points, at least 1.	The Cost (points) is not a whole number of at least 1.	Enter a whole number, 1 or more.	Govee Lights: If something goes wrong
Enter a cooldown between 0 seconds and 7 days.	The Cooldown is outside the allowed range.	Enter a cooldown from 0 seconds (off) up to 7 days.	Govee Lights: If something goes wrong
Could not toggle Govee lights.	The Enable Govee lights switch did not save.	Reload the page, check the switch, and try again.	Govee Lights: If something goes wrong
Could not remove the key.	The saved key could not be removed.	Wait a moment and select "Remove key" again.	Govee Lights: If something goes wrong
"Could not save the reward."	The reward was not created or updated. One possible cause is a channel that is not a Twitch Affiliate or Partner, since the dashboard says Twitch only lets those channels create rewards.	Check the title and cost, then try again. If it keeps failing, check that your channel is a Twitch Affiliate or Partner.	Govee Lights: If something goes wrong
Could not delete the reward.	The reward could not be deleted.	Wait a moment and try again.	Govee Lights: If something goes wrong
"@viewer the lights only change while the stream is live, your points were refunded."	A viewer redeemed the reward while you were offline and "Live only" is on.	Nothing. Go live, or turn off "Live only" if you want offline changes.	Govee Lights: If something goes wrong
"@viewer that colour wasn't recognized, your points were refunded. Try a name like blue or a hex code like #00ccff."	The viewer typed something that is not a known colour name or hex code.	Tell the viewer to type an English colour name like blue, or a hex code like #00ccff.	Govee Lights: If something goes wrong
"@viewer the lights are not set up yet, your points were refunded."	The bot found no working Govee setup for this light when the reward was redeemed.	Open the Govee Lights page. Check that "Key on file" shows and that the light has a reward.	Govee Lights: If something goes wrong
"@viewer the lights are changing too often, your points were refunded. Try again in a moment."	Too many colour changes came in at once, so the bot held this one back.	Ask the viewer to try again in a moment. Add a "Cooldown" to the reward to space changes out.	Govee Lights: If something goes wrong
"@viewer couldn't reach the lights, your points were refunded."	Govee or the light did not answer.	Check that the light is on and shows as online in the Govee Home app. Then try again.	Govee Lights: If something goes wrong

05Discord

at a glanceMessages from the Discord page.

What you see	What it means	What to do	Guide section
"Premium only while in beta"	Your channel is not Premium. Discord is open to Premium channels only during the beta.	Choose "See plans". Come back to "Discord" once Premium is active.	Add Bagel to Discord: If something goes wrong
"Discord is in beta and open to Premium channels only."	Same limit, shown when a Discord action is refused.	Make the channel Premium, then try again.	Add Bagel to Discord: If something goes wrong
"Premium for this channel is managed by {login}. Ask them to upgrade on their Billing page."	You are a mod with shared access, and the Billing section is not shared with you.	Ask the channel owner to upgrade on their Billing page.	Add Bagel to Discord: If something goes wrong
The "Add a server" button is greyed out, or "Discord is not configured on this deployment (missing client id or redirect)."	Discord connection is not set up on Bagel's side. Nothing in your account causes it.	Contact support through the Contact page (itsbagelbot.com/contact) or at support@itsbagelbot.com.	Add Bagel to Discord: If something goes wrong
"You cancelled on Discord's screen, so nothing was added. Choose Add a server to try again."	You closed or cancelled Discord's confirm screen.	Choose "Add a server" again and choose "Authorize" on Discord's screen.	Add Bagel to Discord: If something goes wrong
"Discord did not list a server you can add a bot to. You need to own the server, or have Manage Server on it."	The Discord account you used has no server it can add Bagel to.	Use the Discord account that owns the server or has Manage Server on it.	Add Bagel to Discord: If something goes wrong
"No server we can add Bagel to"	The server list is empty: "Bagel can only be added to a server you own, or one where you have Manage Server."	Ask a server owner for Manage Server, or choose "Create my Discord" to start from Bagel's template.	Add Bagel to Discord: If something goes wrong
"Linked to another channel"	Another Twitch channel already uses this server.	Ask that channel's owner to choose "Disconnect" on the server's Settings page in Bagel. Do not remove Bagel from the server.	Add Bagel to Discord: If something goes wrong
"That Discord server is already linked to another Twitch channel. Ask that channel's owner to open this server in Bagel, go to Settings and choose Disconnect. Then add it here again."	You authorized Bagel on a server that belongs to another channel's setup.	Ask that owner to choose "Disconnect", then add the server again.	Add Bagel to Discord: If something goes wrong
"Discord refused that because Bagel is missing a permission in this server. In Discord, open Server Settings, then Roles, and drag Bagel's role above the roles it manages. If you unchecked a permission when adding Bagel, choose Re-authorize on this server's Settings page and keep them all checked."	Bagel's role sits too low, or a permission was unchecked.	Follow "Fix the role order" above. If you unchecked a permission, choose "Re-authorize" and keep every box checked.	Add Bagel to Discord: If something goes wrong
"This server was added before Bagel asked for the Change Nickname permission, so the premium name cannot be applied here. The premium avatar still works. Choose Re-authorize Bagel, then choose Add Bagel again next to this server."	The server was added with an older permission list.	Choose "Re-authorize Bagel", then "Add Bagel again" next to the server, and keep every permission checked.	Add Bagel to Discord: If something goes wrong
"Bagel needs to be added again to work in this server."	Bagel is not in the server any more, or needs a fresh authorization.	Choose "Add Bagel again" on the server list.	Add Bagel to Discord: If something goes wrong
"Discord did not return a server. Try adding Bagel again."	Discord ended the connection without naming a server.	Choose "Add a server" and start again.	Add Bagel to Discord: If something goes wrong
"That Discord link expired. Start from Add Bagel again."	The page waited too long, or came from an old tab.	Open "Discord" and choose "Add a server" again.	Add Bagel to Discord: If something goes wrong
"Could not save the connected server. Try again."	Bagel could not store the link to your server.	Choose "Add a server" and try again.	Add Bagel to Discord: If something goes wrong
"Someone else saved this server first. Reload and try again."	Two people changed the same server at once.	Choose "Reload", then make your change again.	Add Bagel to Discord: If something goes wrong
"Discord is rate limiting us. Try again in a minute."	Discord is slowing requests down.	Wait a minute and try again.	Add Bagel to Discord: If something goes wrong
"Discord did not answer. Try again in a moment."	Discord did not reply in time.	Wait a moment and try again.	Add Bagel to Discord: If something goes wrong
"This took too long. Some of it may be missing; reload to see the rest."	An action ran past its time limit and may be half done.	Reload the page and check the result.	Add Bagel to Discord: If something goes wrong
"That channel or role is gone from the server. Pick another one."	The channel or role was deleted in Discord.	Pick another one, or choose "Create missing channels and roles".	Add Bagel to Discord: If something goes wrong
"No Discord server is connected yet."	This channel has no linked server, for example after "Disconnect".	Choose "Add a server".	Add Bagel to Discord: If something goes wrong
"Some settings were not valid, so they were left as they were." or "Saved, but these were left as they were: {fields}."	Some values were rejected and kept their old value.	Check the fields marked "Not valid, so this kept the value it already had." and fix them.	Add Bagel to Discord: If something goes wrong
"Bagel cannot post here" or "Bagel can no longer post in the saved channel. Give it Send Messages there, or pick another channel."	Bagel lacks Send Messages in that channel.	Give Bagel "Send Messages" in that channel in Discord, or pick another channel.	Add Bagel to Discord: If something goes wrong
"Turn the ticket desk on and save before reposting the panel."	You asked to repost the ticket panel while tickets are off.	Turn the ticket desk on, save, then repost.	Add Bagel to Discord: If something goes wrong
"Could not list your server's channels and roles, so the pickers are turned off. Nothing was changed; try again in a moment."	Discord did not return the server's channels and roles.	Wait a moment and reload the page.	Add Bagel to Discord: If something goes wrong
"Could not reach the backend. Try again in a moment."	The dashboard could not load your Discord data.	Wait a moment and reload.	Add Bagel to Discord: If something goes wrong
"Could not disconnect Discord." or "Could not set up this server."	The action did not finish.	Try again. If it keeps failing, contact support through the Contact page (itsbagelbot.com/contact) or at support@itsbagelbot.com.	Add Bagel to Discord: If something goes wrong
The status "Offline", or "The gateway dropped and is reconnecting on its own. Nothing to do."	Bagel lost its connection to Discord and reconnects by itself.	Wait a few minutes. If the status says "Reauthorize", choose "Re-authorize Bagel", then "Add Bagel again" next to the server.	Add Bagel to Discord: If something goes wrong
"Something went wrong on our side. Try again, and tell support if it keeps happening."	An unexpected error on Bagel's side.	Try again, then contact support through the Contact page (itsbagelbot.com/contact) or at support@itsbagelbot.com if it repeats.	Add Bagel to Discord: If something goes wrong
"Could not save Discord settings."	The settings on the server's page did not save.	Try again. If it keeps failing, reload the page and make the change again.	Add Bagel to Discord: If something goes wrong
"Could not repost the ticket panel."	Discord did not accept the ticket panel repost.	Try again in a moment. Check that Bagel can post in the ticket channel.	Add Bagel to Discord: If something goes wrong
"Discord rejected the bot token. It has to be replaced before the bot can come back."	A problem on Bagel's side, shown in the server status.	Nothing you can do from the dashboard. Contact support through the Contact page (itsbagelbot.com/contact) or at support@itsbagelbot.com if it lasts.	Add Bagel to Discord: If something goes wrong
"This bot now needs more than one shard. Nothing you can do from here; we are on it."	A problem on Bagel's side, shown in the server status.	Nothing you can do. Wait; Bagel's team is working on it.	Add Bagel to Discord: If something goes wrong
"Discord refused the gateway intents. Nothing you can do from here; we are on it."	A problem on Bagel's side, shown in the server status.	Nothing you can do. Wait; Bagel's team is working on it.	Add Bagel to Discord: If something goes wrong
"Discord has not approved the privileged intents this bot needs. Nothing you can do from here; we are on it."	A problem on Bagel's side, shown in the server status.	Nothing you can do. Wait; Bagel's team is working on it.	Add Bagel to Discord: If something goes wrong
"Bagel joined. This server already has a layout, so it was not rebuilt. Bagel adopted the channels it recognised; pick the rest below."	Bagel joined and kept your existing channels.	Pick the channels that are still empty on the "Channels" page.	Add Bagel to Discord: If something goes wrong

06Share access

at a glanceMessages about share links, billing access, and Premium checkout or gifts.

What you see	What it means	What to do	Guide section
"That share link is no longer valid. Ask the broadcaster for a new one." (sign-in page)	The link was already used, was revoked, or is incomplete.	Mod: ask the broadcaster for a new link. Owner: check "Shared access", then create a new link with "New share link".	Share your dashboard with a mod: If something goes wrong
"Sign-in did not finish on the server. Nothing was saved. Please try again." (sign-in page)	The sign-in stopped before the link was accepted.	Open the share link again. If it then shows the "no longer valid" message, ask for a new link.	Share your dashboard with a mod: If something goes wrong
"That dashboard is no longer shared with you. Ask the owner to send you a new share link." (Settings)	The owner revoked your access, or it ended.	Ask the owner for a new share link.	Share your dashboard with a mod: If something goes wrong
"Could not open that dashboard right now. Wait a moment, then choose Open again." (Settings)	Bagel could not check your access at that moment.	Wait a moment, then choose "Open" again.	Share your dashboard with a mod: If something goes wrong
"That share link is yours, so it opened your own dashboard. It still works. Send it to your mod to open while signed in to their own Twitch account." (Settings)	You opened your own link while signed in as the owner. Nothing was used up.	Send the same link to the mod. They open it signed in to their own Twitch account.	Share your dashboard with a mod: If something goes wrong
"Premium for this channel is managed by {login}. Ask them to upgrade on their Billing page."	You are a mod, a Premium beta page needs Premium, and Billing is not shared with you. {login} is the owner.	Ask {login} to upgrade on their Billing page. Owners can also tick "Billing" under "Edit access".	Share your dashboard with a mod: If something goes wrong
"You do not have access to manage billing."	Billing is not part of what was shared with you.	Ask the owner to add "Billing" under "Edit access", or to handle it.	Share your dashboard with a mod: If something goes wrong
"Only the account owner can do that."	That action is reserved for the owner.	Ask the owner to do it.	Share your dashboard with a mod: If something goes wrong
"Pick at least one section."	The form was sent with every section unticked.	Tick at least one section, then choose "Generate link" or "Save".	Share your dashboard with a mod: If something goes wrong
"Clipboard blocked. Select the link manually."	Your browser blocked "Copy".	Select the link under "Invite links" and copy it yourself.	Share your dashboard with a mod: If something goes wrong
"Could not create link." or "Could not update link." or "Could not revoke link."	The action did not finish.	Try again in a moment. Check "Shared access" to see what was saved.	Share your dashboard with a mod: If something goes wrong
"Could not leave dashboard."	Leaving did not finish.	Try "Leave" again in a moment.	Share your dashboard with a mod: If something goes wrong
Checkout could not open right now. Nothing was charged. Wait a minute, then try again.	Checkout did not open.	Wait a minute, then try again.	Pricing
Subscription management could not open right now. Your plan has not changed. Try again later.	Subscription management did not open.	Try again later. Your plan is unchanged.	Pricing
That streamer has not signed in to ItsBagelBot yet. Ask them to sign in once, then send the gift again.	The gift target never signed in to ItsBagelBot.	Ask them to sign in once, then send the gift again.	Pricing
That account cannot receive Premium. Pick a different streamer.	That account cannot receive Premium.	Pick a different streamer.	Pricing
That streamer already has Premium. Pick someone else to gift to.	The streamer already has Premium.	Pick someone else.	Pricing
Could not check that username right now. Wait a moment, then try again.	The username check failed for now.	Wait a moment, then try again.	Pricing
That is your own account. To get Premium yourself, choose Subscribe monthly or Buy one month.	You typed your own username in the gift field.	Choose Subscribe monthly or Buy one month instead.	Pricing
A checkout for that account is already open. Wait 30 seconds, then try again.	A checkout for that account is already open.	Wait 30 seconds, then try again.	Pricing
This account already has Premium, or a prize month is on the way. Refresh this page to see your current plan.	The account already has Premium, or a prize month is on the way.	Refresh the page to see your current plan.	Pricing
Gift notes cannot contain links or web addresses. Please remove them and try again.	The gift note contains a link.	Remove the link or web address and try again.	Pricing

07Commands and data sources

at a glanceMessages from the command editor and the data source editor.

What you see	What it means	What to do	Guide section
Response is required.	The command reply is empty.	Type a reply, then save.	Commands & variables: Two ways to create one
Reply is too long (max {max} characters).	The reply is over the length limit. {max} stands for the limit.	Shorten the reply or split it into lines.	Commands & variables: The rules of the road
Cooldown must be a whole number of seconds.	The cooldown has a decimal or a letter.	Type a whole number of seconds.	Commands & variables: The rules of the road
User restriction must be a numeric Twitch user id.	The user restriction is a username, not an ID.	Type the numeric Twitch user ID, not the username.	Commands & variables: The rules of the road
Enter a name for this data source.	The data source has no name.	Type a name, then save.	Data sources: Add one from the command editor
Enter the web address to fetch.	The data source has no web address.	Type the web address to fetch.	Data sources: Add one from the command editor
Give the key a label first.	The key has no label.	Type a label, then save.	Data sources: APIs that need a key
Paste the key value first.	The key value is empty.	Paste the key value, then save.	Data sources: APIs that need a key
A key labeled "{label}" already exists. Use Rotate to replace it.	A key already uses that label.	Use Rotate on the existing key, or pick another label.	Data sources: APIs that need a key
Could not save the key.	The key could not be saved.	Try again in a moment.	Data sources: APIs that need a key
Use lower-case letters, digits and underscores only.	The data source name has a capital letter, a space or a symbol.	Use lower-case letters, digits and underscores only.	Data sources: Add one from the command editor
Data source name must be at most 32 characters.	The data source name is too long.	Shorten the name.	Data sources: Add one from the command editor
URL must be at most 512 characters.	The web address is too long.	Use a shorter address.	Data sources: Add one from the command editor
URL must start with https://	The web address does not start with https.	Start the address with https://.	Data sources: Add one from the command editor
URL must point at a public https host.	The web address points to a private or local host.	Use the public https address of the API.	Data sources: Add one from the command editor
Response can be at most 5 lines. Each line is sent as its own chat message.	The command reply has more than 5 lines.	Remove lines until there are 5 or fewer.	Commands & variables: The rules of the road
Each line must be at most 500 characters.	A line of the command reply is too long.	Shorten the line or split it into two lines.	Commands & variables: The rules of the road
The API refused the request. Check the URL, and pick the right key under API key if this API needs one.	The API turned the test away: a wrong or missing key, or a wrong address.	Check the web address. If the API needs a key, add it in Settings under API keys, pick it in the API key field, and test again.	Data sources: What chat shows when it fails
Rate limited. Wait a moment and test again.	A request cap was reached.	Wait a minute and test again.	Data sources: What chat shows when it fails
The API returned an error. Chat sees nothing, unless the token has a \|default: {urlfetch:name\|default}.	The API answered with an error.	Check the API status, or add a fallback after a pipe.	Data sources: What chat shows when it fails
The API timed out. Chat sees nothing, unless the token has a \|default: {urlfetch:name\|default}.	The API took longer than the bot waits.	Try again, and add a fallback after a pipe.	Data sources: What chat shows when it fails
This data source could not produce a value. Until it does, chat shows the token's \|default value if it has one, otherwise {urlfetch:name} as typed. Check the web address and the API key, then click Fetch a sample again.	The source is paused, or its path or address cannot give a value.	Resume the source if it is paused. Otherwise fix the address or key, fetch a sample, and click the value again.	Data sources: What chat shows when it fails
The fetch service did not answer. Try again in a moment.	The service that calls your API did not reply in time.	Wait a moment and test again.	Data sources: What chat shows when it fails
The API answered, but its response could not be read automatically. Paste one below instead.	The answer is not readable text, or it is over 128 KB.	Click "or paste a response instead" and paste a real response by hand.	Data sources: What chat shows when it fails
That is not valid JSON. Fix it and the tree appears here.	The pasted sample is not JSON.	Paste the response again, from the first brace to the last.	Data sources: What chat shows when it fails
That sample is over 128 KB. Paste a shorter one.	The pasted sample is too large for the tree.	Paste a smaller slice of the response.	Data sources: What chat shows when it fails
Too many test runs. Each one calls the real API. Wait about 10 seconds and try again.	Fetch a sample allows about one test every 10 seconds.	Wait 10 seconds.	Data sources: What chat shows when it fails
You've reached the 20 data source limit for your channel. Delete one to make room.	A channel holds 20 data sources.	Delete a source you no longer use.	Data sources: What chat shows when it fails
A data source named "name" already exists.	Another source already has that name.	Pick a different name, or edit the existing source.	Data sources: What chat shows when it fails
A timer message can reference at most 3 different fetched values ({urlfetch:…}).	Timer messages are capped at 3 data sources.	Quote fewer sources in the timer message.	Data sources: What chat shows when it fails
A raw {urlfetch:name} in chat	The source is paused, missing, or cannot produce a value, and the token has no \|default. Tokens past the per-message cap also stay raw.	Open the command, check the name matches a saved source, and resume it if paused. Add a \|default so chat shows a fallback instead.	Data sources: What chat shows when it fails

08Channel points

at a glanceMessages when you create or edit a channel-points reward.

What you see	What it means	What to do	Guide section
Enter a name for this reward.	The reward has no title.	Type a title (up to 45 characters).	Govee Lights: Create the channel-points reward
Title is required (max 45 characters).	The title is empty or too long.	Use 45 characters or fewer.	Govee Lights: Create the channel-points reward
A reward with this title already exists on your channel. Pick another title.	Twitch already has a reward with that title.	Pick another title.	Govee Lights: Create the channel-points reward
Twitch only lets Affiliate and Partner channels create channel point rewards. Once your channel is an Affiliate, click Create reward again.	Twitch gives channel point rewards only to Affiliate and Partner channels.	Become an Affiliate, then select Create reward again.	Govee Lights: Create the channel-points reward
Enter a whole number of points, at least 1.	The cost is not a whole number of at least 1.	Type a whole number of points, at least 1.	Govee Lights: Create the channel-points reward
Enter a valid point cost.	The point cost is not valid.	Type a valid cost.	Govee Lights: Create the channel-points reward
Enter a whole number, at least 1.	A limit field is not a whole number of at least 1.	Type a whole number, at least 1.	Govee Lights: Create the channel-points reward
Enter a cooldown between 1 second and 7 days.	The cooldown is outside the range Twitch allows.	Type a cooldown from 1 second to 7 days.	Govee Lights: Create the channel-points reward
Could not save the reward.	The reward was not saved.	Try again. If it keeps failing, check the fields above.	Govee Lights: Create the channel-points reward

09Bot status

at a glanceMessages on the Bot status card and at the end of the setup.

What you see	What it means	What to do	Guide section
Not connected: "The bot has no Twitch authorization for your channel."	The bot is not signed in to your channel.	Select Connect.	Getting started: If the bot is not in chat
Disabled by you: "Your bot is switched off. Turn it back on to rejoin chat."	You switched the bot off.	Select Enable.	Getting started: If the bot is not in chat
Reconnect needed or Twitch access lost: "Twitch revoked the bot’s access to your channel. This happens after a password change or if the app was disconnected on Twitch. Reconnect your Twitch account to bring the bot back."	Twitch no longer lets the bot act for your channel.	Select Reconnect. It takes you to Settings. There, choose Reconnect Twitch.	Getting started: If the bot is not in chat
Bot banned from your chat: "ItsBagelBot is banned from your chat. To unban it, type /unban ItsBagelBot in your Twitch chat (you or one of your moderators can), or remove it from the banned list in your Twitch Creator Dashboard moderation settings. It rejoins on its own after that." or "ItsBagelBot is banned from your chat. To unban it, type /unban ItsBagelBot in your Twitch chat (you or one of your moderators can), or remove it from the banned list in your Twitch Creator Dashboard moderation settings. Then select I unbanned it, check again."	Your chat banned the bot, so it cannot join.	Type `/unban ItsBagelBot` in your Twitch chat. It rejoins on its own. If the button says I unbanned it, check again, select it. If it says Enable and verify unban, select that.	Getting started: If the bot is not in chat
"ItsBagelBot is still banned from your chat. Type /unban ItsBagelBot in your Twitch chat, then select Enable and verify unban."	The check found the ban still in place.	Unban the bot, then select Enable and verify unban.	Getting started: If the bot is not in chat
Connection check failed: "Access could not be confirmed. Retry when the problem is fixed."	The bot could not confirm its access.	Fix the problem, then select Retry connection check.	Getting started: If the bot is not in chat
Dormant: "The bot wakes automatically when an enabled feature is used. Your settings are preserved."	The bot is resting until something needs it.	Nothing. It wakes on its own.	Getting started: If the bot is not in chat
Timed out: "Normal bot work pauses until the timeout ends and access is verified."	The bot is timed out in your chat.	Wait for the timeout to end. The bot then checks its access again.	Getting started: If the bot is not in chat
Connected · idle: "The bot is connected but not replying in chat."	The bot is in your chat but is not answering.	Select Enable above.	Getting started: If the bot is not in chat
"The bot lost its chat connection, so viewers might not get replies." or "The bot lost its chat connection. Fix it in Settings → Reconnect"	The bot's chat connection dropped.	Select Reconnect. It takes you to Settings. There, choose Reconnect Twitch.	Getting started: If the bot is not in chat
Reconnecting…: "Checking access before restoring operation."	The bot is checking its access before it comes back.	Wait a moment. The state changes on its own.	Getting started: If the bot is not in chat
"Twitch authorization also needs reconnecting."	A second Twitch permission needs renewing.	Select Reconnect next to the message, then choose Reconnect Twitch in Settings.	Getting started: If the bot is not in chat
Checking connection… or Connecting…	The dashboard is still reading the bot's state.	Wait a moment.	Getting started: If the bot is not in chat
Connection status unavailable	The dashboard could not read the bot's state.	Reload the page in a moment.	Getting started: If the bot is not in chat
Accept the Terms and Privacy Policy on the Legal agreements step, then press Finish setup.	The setup was finished without accepting the legal agreements.	Accept them on the step named in the message, then select Finish setup.	Getting started: Connect your channel
Pick a setup on the Tell us more step, then press Finish setup.	No setup is chosen.	Pick one on the step named in the message, then select Finish setup.	Getting started: Connect your channel
Your session ended. Sign in again to finish setup.	Your session ended during setup.	Sign in again, then finish setup.	Getting started: Connect your channel
Only the channel owner can finish setup. Sign in with the channel's own Twitch account.	You are signed in with an account that is not the channel owner.	Sign in with the channel’s own Twitch account.	Getting started: Connect your channel
Could not finish your setup. Some of your choices may already be saved. Press Finish setup to try again.	The setup did not finish saving.	Select Finish setup again.	Getting started: Connect your channel

Last checked: 12 October 2026.