Docs

Command Management

Disable commands and ignore channels.

Configure Command Management in the dashboard →

Overview#

Command management decides what Iris answers to in your server. Turn a command off and it stops working for everyone, on both the slash and the prefix path, without turning off the module behind it.

The other half is channels. Mark a channel as ignored and commands run by ordinary members there are silently blocked, which is how a general chat stays free of bot spam. Moderators and managers can still use commands in an ignored channel.

Turning off a group turns off every subcommand under it. Six commands are exempt and can never be turned off: /help, /command, /ignorechannel and /prefix, which are what a server needs to undo its own configuration, plus /bugreport and /suggest, which talk to the Iris developers rather than to your server.

Setup#

  1. Open the dashboard and go to Server > Command Management.

  2. Search the list under Commands for the one you want to stop.

  3. Turn it off. A group turns off everything under it.

  4. Add any channels members should not run commands in under Ignored Channels.

  5. Save. The change applies immediately, in this server only.

Settings#

SettingTypeDefaultWhat it does
CommandsTogglesAll enabledOne switch per command or group. Off blocks it for everyone on this server.
Ignored ChannelsChannelsNoneOrdinary members cannot run commands here. Staff still can.

Commands#

The dashboard is the comfortable way to do this, but all three commands work from chat as well. None of them can be turned off, which is what stops a server locking itself out.

  • /command [name] Toggle a command or group on or off. Run it with no name to list what is currently disabled. Manage Server
  • /ignorechannel [channel] Add or remove a channel from the ignore list. Defaults to the channel you run it in. Manage Server
  • /prefix [new_prefix] Show the server prefix, or set a new one. Setting it needs Manage Server; reading it does not. Anyone

Permissions#

Nothing extra for Iris. You need Manage Server to open the dashboard for the server, and the setting applies to everyone below moderator level once saved.

Tips and gotchas#

A command still shows in the slash picker.

Discord builds that list itself. Running a disabled command returns a short refusal rather than doing anything.

Staff cannot use commands in an ignored channel either.

Moderators and managers are exempt. If somebody is blocked, they do not hold a moderation permission in that channel.

Why can I not disable some commands?

Six are protected. /help, /command, /ignorechannel and /prefix are held open because disabling /command would leave nothing able to re-enable anything. /bugreport and /suggest are held open because they reach the Iris developers, and that is not a server's to switch off for its members.

Does this affect my custom commands?

The ignore list does. Individual custom commands are turned off by deleting or restricting them on their own page.