Iris
Add to Discord
Docs

Custom Commands

Create custom text and embed commands.

Configure Custom Commands in the dashboard →

Overview#

Custom commands are the answers you find yourself typing twice a week. Write one once and it replies for you, either as a command members run on purpose or as a trigger that fires on plain chat.

A prefix command is typed deliberately: .rules returns your rules. A text trigger watches conversation instead, so somebody asking how to verify gets the answer without having known there was a command for it.

The reply is plain text or a full embed, and usage is counted so you can see which ones earn their place.

Setup#

  1. Open the dashboard and go to Server > Custom Commands.

  2. Press Create Command.

  3. Choose Prefix command or Text trigger under How is it triggered?

  4. Enter the Command name, or the Trigger words and when they should fire.

  5. Write the Response, or fill in the embed fields for something richer.

  6. Under Who can use it? pick Everyone, or restrict it to specific roles and members.

  7. Under Where can it be used? leave it on Every channel, or pick the channels and categories it works in, then save.

Settings#

SettingTypeDefaultWhat it does
How is it triggered?ChoicePrefix commandA command members type with the server prefix, or a trigger that fires on plain chat.
Command nameText-What follows the prefix, 2 to 32 characters of lowercase letters, numbers, - or _. Prefix commands only.
Trigger wordsText-The words watched for, 2 to 64 characters. Text triggers only.
When should it fire?ChoiceMessage is exactly the triggerExactly, starts with, or is like the trigger. Text triggers only.
ResponseTextNoneThe plain text reply.
Embed titleTextNoneHeading of the embed reply.
Embed descriptionTextNoneBody of the embed reply.
Embed colorColour#105380Accent of the embed.
FooterTextNoneSmall line at the foot of the embed.
Thumbnail URLTextNoneSmall image in the top right.
Image URLTextNoneLarge image below the text.
Allowed rolesRolesEveryoneWho may use it. Empty means anybody can.
Allowed membersUser IDsEveryoneIndividual members who may use it, alongside the allowed roles.
Allowed channelsChannelsEvery channelWhere it works. A category allows every channel inside it. Empty means anywhere.

Commands#

  • .custom help Create, list, edit and delete custom commands from chat. Manage Server

Permissions#

PermissionWhy Iris needs it
View ChannelsReads the channels commands and triggers fire in.
Send MessagesPosts the reply.
Embed LinksOnly for commands that reply with an embed.

What it looks like#

M
member Today at 11:22 PM

how do i verify

I
Iris APP Today at 11:22 PM
Getting verified

Head to #verification and press the Verify button. It takes about ten seconds and unlocks the rest of the server.

Still stuck? Open a ticket.
A text trigger answering a question nobody knew to ask a command for.

Tips and gotchas#

A custom command shadows a built-in one.

Built-in commands win. Pick a name Iris does not already use, and check /help if you are unsure.

The trigger fires on bot messages.

It does not. Only member messages are checked.

Can a command take arguments?

No. The reply is fixed text or a fixed embed, the same every time.

Can I keep a command to one channel?

Yes. Set Where can it be used? to Only specific channels and pick them, or run .custom restrict <name> #channel. Anywhere else the bot stays quiet. To silence every command in a channel at once, use the ignore list in command management.