Skip to main content

Expressions

Kite supports performing calculations and transformations on data using expressions. Expressions are available in the Evaluate Expression block (which also supports multi-line input) and in every placeholder surrounded by {{ and }}.

Expression Syntax​

Expressions are powered by the Expr language, you can learn more about the features and syntax here.

Available Variables​

Kite provides the following variables in the expression environment:

user:
  id: string
  username: string
  discriminator: string
  display_name: string
  avatar_url: string
  banner_url: string
  mention: string
  role_ids?: []string
  nick?: string

message?: # For message events
  id: string
  content: string

channel:
  id: string

guild?: # For events and interactions inside a server
  id: string # The id of the server

app:
  user: # Access the underlying user of the app
    id: string
    mention: string

There are also a few special variables for accessing dynamic variables:

arg('name') # Access value of a command argument
input('identifier') # Access value of a modal input
result('id') # Access the result of a previous block

Examples​

When using the Evaluate Expression block, you must omit the {{ and }} from the expression.

Get Command Argument​

This will return the value of the myarg argument passed to the command.

{{ arg('myarg') }}

Get User Display Name​

This will return the display name of the user who clicked the button or triggered the command or event.

{{ user.display_name }}

Get Message Content​

This will return the content of the message that was sent.

{{ message.content }}

Check if User Has Role​

This will return true if the user has the role with the ID 123.

{{ "123" in user.role_ids }}

Do Some Math​

This will return the result of the expression.

{{ 1 + 1 }}

Decode JSON Response​

This will return the value of the somefield field in the JSON response of a HTTP request block with the id owlspush.

{{ fromJSON(result('owlspush').body()).somefield }}