Message variables

Put {user.mention}, {guild.name} and more in any message Gildi sends, and they’re filled in when it goes out.

Anywhere Gildi sends a message (a welcome, a ticket panel, a timed message, a flow step) you can put a variable in curly braces. It’s replaced by the real value when the message is sent.

Welcome to {guild.name}, {user.mention}!
You are member number {guild.member_count}.

Which variables work where

The Everywhere variables below work in every message. The others depend on what set the message off: a welcome knows who joined, a message trigger knows the message, a slash command knows its options. The dashboard’s message builder only offers the variables that work in that spot, and flags any it doesn’t know.

Changing how a value looks

Add a filter after a | to change how a value is shown:

Filter What it does Example
upper, lower Changes the case {user.name | upper}
default: "x" Shows x when the value is empty {member.nick | default: "no nickname"}
truncate: n Cuts it to n characters {message.content | truncate: 50}
ordinal 1 becomes 1st, 2 becomes 2nd {member.rank | ordinal}
plus: n Adds a number {member.level | plus: 1}
relative A date as “3 days ago”, in each reader’s time zone {member.joined_at | relative}
date: D A date in one of Discord’s styles: t, T, d, D, f, F or R {user.created_at | date: D}

Dates are sent as Discord timestamps, so everyone sees them in their own time zone. The timestamp generator shows what each style looks like.

Mentions and pings

{user.mention} pings the member; {user.name} is only text. Gildi also stops members from mass-pinging through it: a role mention, @everyone or @here that comes from something a member typed, like a form answer or a message, is shown but doesn’t ping. Role mentions you write into the message yourself still ping.

Your own values

Flows can store values per server or per member and read them back as {vars.server.name} or {vars.member.name}. Slash command options are {options.name}, and form answers are {answer.1} to {answer.25}.

Reference

The member

VariableGives you
{user}Mention of the member
{user.mention}Mention of the member
{user.name}Display name
{user.username}Username
{user.id}User ID
{user.avatar}Avatar image URL
{user.created_at}Account creation date (use | relative)
{member.name}Name shown in this server
{member.nick}Server nickname
{member.joined_at}When they joined (use | relative)
{member.level}Level
{member.xp}Total XP
{member.rank}Leaderboard rank
{member.balance}Currency balance

The channel

VariableGives you
{channel}Mention of the channel
{channel.mention}Mention of the channel
{channel.name}Channel name
{channel.id}Channel ID

The message

VariableGives you
{message.content}Message text
{message.id}Message ID
{message.url}Link to the message
{message.author}Who wrote it (mention)
{message.author_name}Who wrote it
{message.author_avatar}Their avatar image URL
{message.image}The first image in it (empty if none)
{message.attachments}How many files are attached
{message.created_at}When it was sent (use | relative)

Old message

VariableGives you
{message.old_content}Text before the edit
{message.files_removed}Files the edit removed

Deleted message

VariableGives you
{message.details}What it said, who deleted it, its files, embeds and stickers, or why Gildi has no copy
{message.author_line}Who wrote it, with their username, even if they left

Options

VariableGives you

The member it’s used on

VariableGives you
{target}Mention of the member clicked
{target.name}Their name in this server
{target.username}Their username
{target.id}Their user ID
{target.avatar}Their avatar image URL
{target.created_at}Account creation date (use | relative)
{target.nick}Their server nickname
{target.joined_at}When they joined (use | relative)

Values

VariableGives you
{values}Chosen values, comma-separated

Fields

VariableGives you

Reaction

VariableGives you
{reaction.emoji}The emoji
{reaction.count}How many people reacted with it

Inviter

VariableGives you
{inviter}Who invited them (mention)
{inviter.name}Who invited them
{inviter.uses}Uses of that invite
{inviter.invites}Their real invites (Invite tracking)

Invites

VariableGives you
{invites}Real invites they have now

Room

VariableGives you
{room}The voice room (mention)
{room.name}Room name
{room.id}Room channel ID
{room.minutes}Minutes it was open (when closed)

Role

VariableGives you
{role}Mention of the role
{role.name}Role name
{role.id}Role ID

Voice

VariableGives you
{voice.channel}Voice channel (mention)
{voice.channel.name}Voice channel name
{voice.old_channel}Previous voice channel
{voice.change}What changed, such as Camera
{voice.on}Whether it turned on (true or false)

Event

VariableGives you
{event.name}What happened
{event.actor}Who did it (mention)
{event.target}What it happened to
{event.reason}Reason given
{event.details}Details

Thread

VariableGives you
{thread}The thread (mention)
{thread.name}Thread name
{thread.id}Thread ID
{thread.parent}The channel it is in (mention)
{thread.archived}Whether it is archived
{thread.locked}Whether it is locked

Scheduled event

VariableGives you
{scheduled_event.name}Event name
{scheduled_event.description}Event description
{scheduled_event.status}Scheduled, Active, Completed or Canceled
{scheduled_event.starts_at}When it starts (use | relative)
{scheduled_event.location}Where it is
{scheduled_event.url}Link to the event
{scheduled_event.id}Event ID

Poll

VariableGives you
{poll.question}The question
{poll.answer}The answer they voted for
{poll.answer_id}Number of that answer

Level

VariableGives you
{level}The new level

Currency

VariableGives you
{currency.name}Currency name
{currency.emoji}Currency emoji

Daily

VariableGives you
{result.amount}What they got
{result.streak}Days in a row
{result.balance}Their balance now

Item

VariableGives you
{item.name}Item name
{item.price}Item price

Case

VariableGives you
{case.number}Case number
{case.kind}Case kind
{case.reason}Case reason
{case.moderator}Moderator (mention)

Body

VariableGives you

Ticket

VariableGives you
{ticket.number}Ticket number
{ticket.category}Ticket category
{ticket.channel}The ticket thread or channel (mention)
{ticket.claimed_by}Who claimed it (mention)
{ticket.closed_by}Who closed it (mention; empty when it closed itself)

Form

VariableGives you
{form.name}Form name
{form.answers}Every question and answer
{form.reviewer}Who decided (mention)
{form.reason}Reason given for a no
{answer.1}Answer to question 1 (answer.2 for the second, and so on)

Giveaway

VariableGives you
{giveaway.prize}The prize
{giveaway.winners}Every winner (mentions)
{giveaway.entries}How many entered
{giveaway.url}Link to the giveaway

Suggestion

VariableGives you
{suggestion.title}Idea title
{suggestion.body}Idea details
{suggestion.status}Status (Under review, Planned, Done, Declined)
{suggestion.note}Staff note
{suggestion.url}Link to the post
{suggestion.up}Votes for
{suggestion.down}Votes against
{suggestion.votes}The vote count in words
{suggestion.category}Category it was filed under
{suggestion.author}Who posted it, or Anonymous
{suggestion.channel}Where the post is
{suggestion.id}Short ID for /suggestion status

Appeal

VariableGives you
{appeal.case}Case number
{appeal.kind}What it is about (ban, timeout, warn)
{appeal.reason}Reason on the case
{appeal.status}Status (open, accepted, denied, final)
{appeal.message}The message to the member
{appeal.reviewer}Who decided (mention)
{appeal.invite}One-time invite for an accepted ban (empty otherwise)
{appeal.url}Link to the appeal page

Everywhere

VariableGives you
{guild.name}Server name
{guild.id}Server ID
{guild.icon}Server icon URL
{guild.member_count}Member count (use | ordinal)
{date}Now (use | date or | relative)
{stats.members}Members
{stats.humans}People (members who are not bots)
{stats.bots}Bots
{stats.online}Online now
{stats.boosts}Server boosts
{stats.goal}Member goal