!command

The !command (aliased as !cmd) command suite allows streamers and moderators with the appropriate permissions to manage custom chat commands directly from the chat interface. It provides subcommands to add, remove, edit, view aliases, show details, and configure advanced options for any custom command.

Usage

The general syntax follows this pattern:

!command <subcommand> [arguments...]

Or using the alias:

!cmd <subcommand> [arguments...]

Replace <subcommand> with one of the functions listed below and [arguments...] with the required parameters for that specific subcommand.

Subcommands

Here are the available subcommands for !command:

add

Creates a new custom command.

Syntax:

!command add !<command_name> <response_text>

Example:

Example chat

ModUser:!command add !socials Follow me on Twitter @MyHandle!

StreamElements:@Moderator, successfully added command !socials.

remove

Deletes an existing custom command.

Syntax:

!command remove !<command_name>

Example:

Example chat

ModUser:!command remove !socials

StreamElements:@Moderator, successfully removed command !socials.

edit

Changes the response text of an existing custom command.

Syntax:

!command edit !<command_name> <new_response_text>

Example:

Example chat

ModUser:!command edit !socials Check out my links: example.com/links

StreamElements:@Moderator, successfully updated command !socials.

alias

Shows the aliases associated with a specific command, or adds/removes an alias.

Syntax:

!command alias !<command_name>
!command alias add !<command_name> !<alias_name>
!command alias remove !<command_name> !<alias_name>

Note

Listing aliases only works with the original command name, not with one of its aliases.

Example (listing aliases):

Example chat

ModUser:!command alias !socials

StreamElements:@Moderator, Command !socials has aliases: !links, !connect

Example (adding an alias):

Example chat

ModUser:!command alias add !socials !links

StreamElements:@Moderator, successfully added alias !links to command !socials.

Example (removing an alias):

Example chat

ModUser:!command alias remove !socials !links

StreamElements:@Moderator, successfully removed alias !links from command !socials.

show

Displays the full response text and configuration details (level, cost, cooldowns) of a command.

Syntax:

!command show !<command_name>

Example:

Example chat

ModUser:!command show !socials

StreamElements:@Moderator, Command !socials: Check out my links: example.com/links (Level: Everyone, Cost: 0, Cooldown: 5s, User Cooldown: 15s)

options

Configures advanced settings like cooldowns, cost, permission level, response type, trigger name, enabled status, and usage count for a command. See the Parameters section below for details on the available options.

Syntax:

!command options !<command_name> <option1> <value1> [option2] [value2] ...

Note

Replace option1, value1, etc., with the specific parameter flags and values listed in the Parameters section below. You can specify multiple options.

Example (setting multiple options):

Example chat

ModUser:!command options !socials -cd 10 -usercd 30 -cost 50 -level 500

StreamElements:@Moderator, successfully updated command !socials.

Parameters (for options subcommand)

When using the !command options subcommand, you specify settings using flags followed by their values. You can set multiple options in a single message. These parameters allow fine-grained control over a command’s behavior:

Parameter	Description	Accepted Values	Example Usage
-cd	Sets the global command cooldown (minimum time between any use of the command).	<seconds> (e.g., 10)	-cd 10
-usercd	Sets the user-specific cooldown (minimum time the same user must wait before using the command again).	<seconds> (e.g., 30)	-usercd 30
-cost	Sets the loyalty points cost charged each time the command is used. If a user doesn’t have enough points, the command silently does nothing (no error message is sent). Requires the StreamElements Loyalty System (enabled in the dashboard under Loyalty → Loyalty Settings).	<points> (e.g., 50)	-cost 50
-level	Sets the minimum user permission level required. Takes a number: 100 (Everyone), 250 (Subscriber), 300 (Regular), 400 (VIP), 500 (Moderator), 1000 (Super Moderator). No other values are accepted.	<number> (e.g., 500)	-level 500
-type	Sets how the bot responds. Platform support for reply, mention, and whisper may vary.	say (default), reply, mention, whisper	-type whisper
-trigger	Renames the command, changing the trigger word used to invoke it.	<new_name> (e.g., !links)	-trigger !links
-enable	Enables the command.	N/A	-enable
-disable	Disables the command, preventing anyone from using it.	N/A	-disable
-count	Manually sets the command’s usage counter, useful for resetting or adjusting the value used by $(count).	<number> (e.g., 0)	-count 0

Subcommand aliases

Each subcommand also accepts its own shorthand aliases:

• remove: delete, del, rem
• edit: update
• alias: aliases
• show: debug
• options: option, opt, opts, o, 🔧

Related Commands

• !commands: Lists available commands.
• $(count): Variable to display the usage count of a command.
• $(user): Variable representing the user executing the command.
• $(channel): Variable representing the channel name.
• See the full list of Chatbot Variables.

FAQ

• What’s the difference between global cooldown (-cd) and user cooldown (-usercd)? Global cooldown (-cd) applies to everyone – once the command is used, no one can use it again until the cooldown expires. User cooldown (-usercd) applies only to the individual user – they have to wait, but other users can still use the command if the global cooldown has passed.

• How do I reset a command’s usage counter? Use the options subcommand with the -count parameter: !command options !<command_name> -count 0

• Can I make a command respond with a whisper instead of a public message? Yes, use the options subcommand with the -type parameter: !command options !<command_name> -type whisper. Note that whisper functionality depends on the chat platform.

• How do I add or remove a command alias via chat? Use the alias subcommand with add or remove: !command alias add !<command_name> !<alias_name> or !command alias remove !<command_name> !<alias_name>.

• I’m a moderator, but !command add isn’t working. Why? Double-check that the !command default command itself hasn’t been disabled or had its permission level changed from the default (Moderator). You can check its settings in the Default Commands section of your StreamElements Dashboard.