How to use ChatSpire

Getting started 2 minutes

1. Open the portal: chatspire.app. It's also in the bot's Twitch bio at twitch.tv/chatspire.
2. Log in with Twitch. Click Log in with Twitch and approve on Twitch. ChatSpire only gets read access to your channel's events (follows, subs, bits, raids, redemptions). It can never post as you.
3. ChatSpire joins your chat within a minute, with alerts, stats and your public command list switched on.
4. Make the bot a mod. In your Twitch chat, type /mod chatspire. This unlocks follow alerts, moderation, clips, watch time for lurkers and faster replies. Without it, a lot of features stay off.
5. Follow the checklist. The Overview page has a "Get the most out of ChatSpire" checklist that ticks itself off as you go.

Anything you save on the portal is live in chat right away. You never need to restart anything.

Finding your way around

The menu on the left has one page per job. Bigger pages have tabs along the top (for example Commands → Stats). On a phone, the menu becomes a strip you can swipe.

Master switches: Commands, Timers, Alerts & messages, Giveaways, Rewards and Moderation each have one switch at the very top of the page that turns the whole section off for your channel. Nothing is deleted, so switch it back on and everything works like before. The menu shows OFF next to a switched-off section.

Use the Feedback button at the top of the portal to send an idea or report a problem straight to the bot owner.

Commands

You make commands on the portal, not in chat: there's no !addcom. Go to Commands and click + New command.

1. Name: what viewers type, without the ! (for example discord).
2. Reply: what ChatSpire says. Use variables to fill in details (see the table below).
3. Who can use it: Everyone, Subscribers (plus VIPs, mods and you), Mods (plus you), or Streamer only.
4. Cooldown: seconds before it can be used again.
5. Save. The command works in chat straight away.

Useful extras

• Random replies: click Add a random reply to give a command up to 10 replies. ChatSpire picks one each time and never repeats the same one twice in a row. Great for !lurk or !8ball.
• Reply when nobody is named: set a separate reply for when the command is used alone. For example, !hug on its own says "Who do you want to hug?" while !hug @friend hugs them.
• Emotes: click the 😀 button inside any reply box to add your channel's emotes (Twitch, 7TV, BetterTTV and FrankerFaceZ), Twitch's global emotes or emoji. Search by name; the ones you use most show first. It works in every box where you write something ChatSpire says: commands, timers, alerts, welcomes and the Live page. A green ✓ marks the Twitch emotes the bot can actually use; a red ✕ means it would show as plain text. Twitch sub emotes only work if the bot is subscribed to your channel (you can gift it a sub), and follower emotes need it to follow you. 7TV, BetterTTV and FrankerFaceZ emotes show for viewers who have those extensions.
• Folders: put commands in folders like Fun, Info or Mods to keep the list tidy.
• Command gallery: ready-made commands (!lurk, !hug, !8ball, !coinflip, a death counter and more). One click adds one, then edit and save.
• Import: coming from Nightbot or StreamElements? Click Import, then paste your commands or fetch them. Variables, cooldowns and permissions are converted for you.
• Built-in replies (Commands → Built-in replies): change what !watchtime, !top, !uptime, !clip and the other built-in commands say.
• Stats (Commands → Stats): how often each command is used, and which ones nobody uses.

Variables you can use in replies

Viewers type !commands to get a link to a public page listing every command they can use. Mod-only and streamer-only commands stay hidden.

Alerts, timers, welcomes & Discord

These automatic messages keep chat lively. Set each one up once and it runs by itself.

• Alerts (Alerts & messages → Alerts): the thank-you messages for follows, subs, resubs, gift subs, bits, raids and channel point redemptions. Write your own wording and switch single alerts off. One switch at the top turns posting alerts in chat on or off.
• Timers (Timers page): up to 10 messages repeated every few minutes, like your Discord link or schedule. They only post while you're live and only after chat has been active, so they never talk to an empty room. Send now tests one.
• Welcome first-time chatters (Alerts & messages → Chat messages): greets someone the first time they ever chat in your channel. Off until you switch it on.
• Welcome back regulars: greets people who come back after being away for 14 days (you can change the number). Off until you switch it on.
• Lurk tracking (Alerts & messages → Chat messages, on by default): when someone types !lurk and later chats again, ChatSpire says "👀 Welcome back @Sam — you lurked for 2h 10m!". If you have your own !lurk command, it still answers; ChatSpire just remembers.
• Milestones (Alerts & messages → Milestones): set your own goals — followers, subscribers or viewers watching — and ChatSpire celebrates in chat (and in your Discord) when you reach one. Each one celebrates once; Quick add suggests your next follower goals.
• Stream updates (Alerts & messages → Chat messages, on by default): while you're live, changing your category or title (on the portal, or anywhere on Twitch) is announced in chat, for example "🎮 Now playing: Valorant". Changes made on Twitch are noticed within a minute. Edit the wording or switch it off there.
• End-of-stream thank you: when you go offline, ChatSpire posts a short recap, for example "That's a wrap! 3h 12m live · 41 new followers · MVP chatter: @Sam".
• Shoutouts (Commands → Clips & shoutouts): mods type !so @name, and ChatSpire also presses Twitch's own Shoutout button. You can shout out raiders automatically too.
• Discord (Alerts & messages → Discord): paste a Discord webhook link and ChatSpire posts once when you go live, with your title, game and stream preview. You choose who it pings (nobody, @here or @everyone), and it can post a stream recap when you end. Send a test post never pings anyone.

To get a Discord webhook link: in Discord, open your channel's settings → Integrations → Webhooks → New Webhook → Copy Webhook URL.

While you're live

Keep the Live page open on a second screen or your phone. It shows your chat and has a button for everything you'd normally open Twitch's dashboard for.

Giveaways (Giveaways page): set the prize, the word viewers type to enter (!join by default), who can enter (everyone, followers or subs), extra luck for subs and an optional timer. ChatSpire announces it, confirms entries in chat and draws the winner. The page then shows what the winner says in chat so you know they're there. Reroll picks someone else.

YouTube chapters: every marker you or your mods add (button or !marker) is saved. After the stream, go to Analytics → Past streams and click Copy as YouTube chapters to paste them into your YouTube description.

Loyalty: levels, currency & games

Reward the people who show up. Everything on the Loyalty page starts off: switch Loyalty on with the switch at the top, then turn on the parts you want. Viewers only earn while you're live, and bots never earn.

• ⭐ Levels & ranks: viewers get XP for chatting (once every 30 seconds, so spam doesn't pay) and for watching (every 5 minutes). Level 5 takes about 6 hours of stream, level 10 about 18 with the default settings, and the page shows the times for your own numbers. Give each level range a rank name (Newcomer, Regular, Veteran…). ChatSpire can announce level-ups in chat, or only new ranks. Viewers type !rank.
• 🪙 Currency: your own points, named whatever you like (coins, gems, bananas…), earned the same way. Subs and VIPs can earn double from chatting. Viewers type !points (you can rename it) and can share with !give @name 50. Mods use !addpoints @name 100 / !removepoints @name 100, or the Give box on the Leaderboard tab.
• 🎲 Games (need Currency on), each with its own switch, min/max bet and cooldown:
  • !gamble 100 (or !gamble all): roll 1–100; 61–98 doubles the bet, 99–100 triples it.
  • !slots 50: two matching pay 1.5×, three matching 5×, three 💎 10×.
  • !flip 50 heads: call the coin flip and double your bet.
  • !duel @friend 100: challenge someone who's in chat right now (not yourself). They type !accept within 60 seconds (or !deny). Nothing is taken unless they accept; then the winner takes both bets.
• 🏆 Leaderboard: see everyone's level, XP and currency, find someone, and give or take currency. !leaderboard in chat shows the top 3 and links to a public leaderboard page (you can switch the page off). Reset all XP or Reset all currency starts a new season.

Song requests on Spotify 3 minutes, once

Viewers request songs and ChatSpire puts them straight into your Spotify queue. You need Spotify Premium (Spotify only lets Premium accounts add to a queue), and Spotify must be open and playing on your PC or phone while you stream.

1. Open 🎵 Song requests and follow the steps: make your own free app in the Spotify developer dashboard (Spotify limits each app to a few users, so every streamer makes their own), paste the Redirect URI ChatSpire shows you, tick Web API, then paste the app's Client ID and press Connect Spotify.
2. Pick how viewers request: 💎 Create “Song request” reward (channel points; needs Extra features and Affiliate/Partner) and/or ⌨ !sr song name in chat (everyone, subs & VIPs, VIPs or mods, with a wait time per person).
3. Switch Song requests on. Use Add to my queue at the bottom to try it.

• Viewers type a song name (one more time daft punk) or paste a Spotify song link.
• Too long, explicit (if you block those), not found, or Spotify isn't playing? ChatSpire says why in chat, and channel points are refunded.
• !song shows what's playing with its link · mods can !skipsong · !spotify posts your Spotify profile or playlist (add the link on the page).
• By default requests only work while you're live — switch Only while I'm live off if you want them anytime.

Growing your channel

• 🧭 Discover: when you're live, your stream shows on ChatSpire's public Discover page, where viewers find streamers by game — smallest streams first, so everyone gets a turn. Don't want to be listed? Settings → Channel → Discover page.
• 🖼️ Recap card: after each stream, click Share card on the Overview's "Last stream" (or Analytics → Past streams) to get a colorful image of your stats. Download it, copy it, or post it to your Discord in one click.
• 🔗 Link clicks (Analytics → Links): switch it on and the links ChatSpire posts in your chat — your Discord, socials, sponsors — go out as short links that count clicks, then send people straight on. You see clicks today, this week, this month and all time for every link. Twitch links and ChatSpire's own pages are left alone, and link-preview bots and repeat clicks don't count.

Moderation

All moderation needs ChatSpire to be a mod in your chat (/mod chatspire). You, your mods and VIPs are never affected by any of it.

• Spam-bot shield (on by default): bans the "buy followers / viewers" ad bots on their very first message, even when they disguise links. Subscribers and anyone who has chatted before are never checked, and borderline cases only get a 10-minute timeout. Every catch is listed with an Unban button. If spam still gets through, switch on Strict mode. If a word or site you use keeps getting caught, add it under "never spam".
• Chat rules (all off until you switch them on):
  • Block links, with a list of allowed sites. Mods can type !permit @name to allow one link.
  • Too many capitals and Emote spam, with limits you set.
  • Banned words, one per line (* is a wildcard), set to delete the message, time out for 10 minutes, or ban.
  • Links, caps and emotes are gentle: the first slip only deletes the message, then a 1-minute and a 10-minute timeout follow.
  • Go easy on subscribers lets subs post links, caps and emotes. Tell people why posts a short note in chat.
• Mod log (Moderation → Mod log): every ban, timeout and deleted message from the last 90 days, whether by ChatSpire or by your mods, with Unban and Remove timeout buttons.
• Shared ban list (Settings → Channel, off by default): once you join, a permanent ban in your channel is copied to every other channel on the list, and theirs to yours. Timeouts aren't shared, and unbanning someone lifts the shared bans too.
• Viewer lookup (Viewers page): type any username to see the account's age (with a warning for brand-new accounts), follow age, sub, messages, watch time and mod history. Time out, ban or unban from there.

Giving your mods access

Your mods can run ChatSpire for you from their own Twitch account. They never need your password.

1. Go to Settings → Mods. Type the mod's Twitch username (or click one of the "Mods seen in your chat" suggestions) and click Give access.
2. Send them the portal link: chatspire.app
3. The mod opens it, clicks I'm a moderator and logs in with Twitch. Your channel shows up for them right away. Mods of several ChatSpire channels switch between them at the top of the menu.

Choose what each mod can touch. Each mod's row has buttons for Live tab, Commands, Timers, Alerts & messages, Giveaways, Channel point rewards, Viewer lookup and Moderation & mod log. Everything is allowed until you switch something off.

Mods can never open Settings, see your Discord link, or remove ChatSpire. Removing a mod takes effect immediately. Every change a mod makes shows up under Activity, where you can undo it.

Your own bot name 1 minute

Want ChatSpire to talk in your chat as YourNameBot instead of chatspire? A Twitch name belongs to one account, so you make a free Twitch account for your bot and ChatSpire talks through it, only in your chat. Go to Settings → Bot name:

1. Type the name you want. ChatSpire checks straight away whether it's free on Twitch.
2. Create the account. Open a private / incognito window, go to Twitch's sign-up page (there's a Copy sign-up link button) and use that name. You can use the same email or phone as your channel. Skip this if the account already exists and is yours.
3. Click Connect my bot, paste the link it gives you into that same private window and click Authorize. The portal shows "Talking as …" when it's done.
4. Make it a mod: click Copy /mod command and paste it in your chat, so slow mode, followers-only mode and link blocking never stop it.

Everything else stays the same. ChatSpire still reads your chat with chatspire, so that name can still show in your viewer list. Give your bot a profile picture on Twitch and it shows in chat too. Go back to the ChatSpire name undoes it at any time. If your bot account ever loses access, ChatSpire talks as chatspire again until you reconnect it, so nothing is missed.

Stats, rewards & safety nets

• Analytics: messages, chatters, follows, subs, bits, raids and viewers for any day, week, month or year, compared with the period before. The tabs along the top add Best time to stream (a heatmap of when chat is busiest), New vs returning chatters per stream, Top supporters by bits, gifted subs and subs, Top emotes (including 7TV, BetterTTV and FrankerFaceZ), and Past streams with a recap of each one.
• Bots stay out of your stats (Analytics → Bots): watch time, top chatters, !top, !watchtime ranks, recaps and chatter numbers only count real people. ChatSpire recognises well-known bots (Nightbot, StreamElements…) and viewer bots (accounts sitting silently in lots of channels at once) by itself. Add your own extra bots there, or open someone in Viewers and click This is a bot. Got it wrong? Not a bot counts them again. Past stats are cleaned up too.
• Bots stay out of your stats (Analytics → Bots): watch time, top chatters, !top, !watchtime ranks, recaps and chatter numbers only count real people. ChatSpire recognises well-known bots (Nightbot, StreamElements…) and viewer bots (accounts sitting silently in lots of channels at once) by itself. Add your own extra bots there, or open someone in Viewers and click This is a bot. Got it wrong? Not a bot counts them again. Past stats are cleaned up too.
• Overview: your latest stream recap and your top 5 clips (this week, this month or all time) with who made them.
• Rewards: create channel point rewards that make ChatSpire say something, run one of your commands, or enter the current giveaway. Redemptions are marked done automatically, and refunded if something goes wrong. Needs Extra features and an Affiliate or Partner channel.
• Activity: every change made by you, your mods or the bot owner. Click Undo to put something back the way it was.
• Settings → Logins: every device logged in to your portal (yours and your mods'), with Log out for any you don't recognise. You can also get an alert in a private Discord channel whenever someone new logs in.
• Settings → Channel → Remove ChatSpire: the bot leaves your chat and its access is removed, including from your Twitch Connections. Your commands and stats are kept in case you come back. Disconnecting ChatSpire from twitch.tv → Settings → Connections works too: the bot leaves your chat straight away.

Built-in chat commands

These work without any setup. Change what they say under Commands → Built-in replies.

These names are taken: a command of your own called !uptime, for example, won't run. To change what a built-in says, use Built-in replies.

Common questions