Automations
Reference
Every setting, every placeholder, and what to check when something does not fire.
Trigger settings
| Setting | Applies to | Notes |
|---|---|---|
| Mode | all | Close enough wording, Starts with a command, Pattern (regex), Watch a channel, You post it yourself |
| Trigger | wording, command, pattern | The phrase, the command, or the pattern |
| Match percentage | wording | 5 to 100. Default 85 |
| Capitals have to match | wording, command | Off by default |
| OCR trigger detection | wording, pattern | Uses AI Credits |
| Delete the member's message | everything except panels | |
| Channels to watch | watch a channel | At least one is required |
Conditions
| Setting | Notes |
|---|---|
| Allowed channels | Fires only in these |
| Ignored channels | Never fires in these |
| Only inside tickets | Ticket channels only |
| Required roles 👑 | Match any of them, or all of them |
Argument settings
| Setting | Notes |
|---|---|
| Name | Lowercase letters, numbers and underscores, up to 32 characters. This is the placeholder name |
| Label | What it is called in the usage line. Falls back to the name |
| Type | Text, Number, Choice, List, User, Role, Channel, Yes or no |
| Members must provide it | Otherwise the automation posts without it |
| Takes the rest of the message | Last argument only |
| Default | Used when the member leaves it out |
| Choices | Choice arguments. Up to 25, each up to 100 characters |
| Separator | List arguments. A dash by default |
| Min and max | Number: the value range. Text: length. List: how many items |
Placeholders
Everything in the placeholder catalog works in an automation's message, plus these:
| Placeholder | Gives you |
|---|---|
{args.raw} | Everything typed after the trigger |
{args.<name>} | One argument's value |
{args.<name>.mention} | A ping, for user, role and channel arguments |
{args.<name>.count} | Number of items in a list argument |
{args.<name>.0} | An item of a list by position, starting at 0 |
Not supported: {args.list[0]}, {args.list.length}, and looping over a list.
A panel you post yourself has no member and no trigger message behind it, so member.* and args.* placeholders have nothing to fill in there. The editor only offers the ones that resolve.
Button and menu groups
| Setting | Notes |
|---|---|
| Buttons or dropdown | 5 buttons per row, 25 options in a dropdown |
| Behavior | Links, Roles, or Votes |
| Options | Label, plus a URL for links or a role for roles |
| Build the options from an argument | Uses a list argument instead of the options above |
| Only one at a time | Roles: replaces the previous pick. Votes: moves the vote |
| Show the counts | Votes: renders the tally into the labels |
| Stops accepting votes after | Votes: 1 hour up to 3 months from posting, a month by default. There is no never |
| Placeholder text | Dropdowns only |
Limits
| Free | Premium | |
|---|---|---|
| Automations that fire | first 10 | all |
| Automations you can store | 100 | 100 |
| Groups per automation | 1 | 5 |
| Options per group | 5 | 25 |
| Arguments | 3 | 10 |
| Poll answers | 4 | 10 |
| Pick more than one poll answer | no | yes |
| Link buttons | 5 | 25 |
| Threads | no | yes |
| Delete after a delay | no | yes (up to 5 minutes) |
| Steps | no | yes (up to 10) |
| Components layout reply | no | yes |
Nothing is deleted when premium ends. Everything you configured is kept and comes back when it returns.