Nightbot Commands

Nightbot ships with default commands like !commands, !title, !game, !songs and !winner. You add your own from chat with !commands add !name response (mods and the owner only), or in the control panel under Commands → Custom. Variables such as $(user), $(touser) and $(count) make responses dynamic.

Default Nightbot commands

These are built in and work as soon as Nightbot joins your channel and is a moderator. You can disable any of them, or change their userlevel and cooldown, on the Commands → Default page of the control panel.

Add, edit and delete custom commands in chat

You and your moderators can manage custom commands without leaving chat. Command names can’t contain spaces and usually start with !.

Options: userlevel, cooldown and alias

Put options between the command name and the response. They work with both add and edit:

!commands add !so -ul=moderator -cd=30 Go follow $(touser) at https://twitch.tv/$(touser)

• -ul= sets who can use the command: owner, moderator, twitch_vip, regular, subscriber or everyone (the default).
• -cd= is the cooldown, the minimum number of seconds between uses.
• -a= makes the command call another command (an alias). The response text is passed to that command as its input, so use a variable like $(query) to forward what the user typed.

Nightbot responses can start with /me or /announce (plus /announceblue, /announcegreen, /announceorange, /announcepurple) on Twitch. Other slash commands are not supported in responses.

Add a command from the dashboard

1. Sign in at nightbot.tv and open Commands → Custom in the left menu.
2. Click Add Command.
3. Fill in Command (for example !discord) and Message (the response, variables allowed).
4. Set Userlevel and Cooldown. Use Alias only if this command should call another one.
5. Save. To change or remove a command later, use the pencil or trash can button in the command table.

Useful Nightbot variables

Variables go inside the response and are replaced when the command runs. These are the ones you’ll use most:

There is no $(uptime) variable in Nightbot. Use $(twitch $(channel) "{{uptimeLength}}") instead, as in the example below.

15 ready-to-copy Nightbot commands

Click a command to copy it, replace the placeholder links and names, then paste it into your chat while Nightbot is in the channel.

$(count) counts uses of the command it sits in, so create a separate command for each thing you want to track. For a fuller shoutout setup, including Twitch’s native /shoutout, see the Twitch shoutout command guide.

Nightbot vs. StreamElements syntax

Commands copied from a StreamElements tutorial won’t work in Nightbot as-is. Nightbot uses !commands add and variables like $(touser), while StreamElements uses !command add (or !cmd add) and its own variable set. See the StreamElements commands guide if you use that bot, and the Twitch chat commands guide for built-in slash commands.

Want chat on stream without bot replies cluttering it? Our free Twitch chat overlay hides Nightbot and messages starting with !.

Sources: Nightbot docs: Default commands · Nightbot docs: !commands · Nightbot docs: Control panel commands · Nightbot docs: Variables · Nightbot docs: Twitch variable · Nightbot docs: Troubleshooting