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
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {channel} | Mention of the channel |
| {channel.mention} | Mention of the channel |
| {channel.name} | Channel name |
| {channel.id} | Channel ID |
The message
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {message.old_content} | Text before the edit |
| {message.files_removed} | Files the edit removed |
Deleted message
| Variable | Gives 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
| Variable | Gives you |
|---|
The member it’s used on
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {values} | Chosen values, comma-separated |
Fields
| Variable | Gives you |
|---|
Reaction
| Variable | Gives you |
|---|---|
| {reaction.emoji} | The emoji |
| {reaction.count} | How many people reacted with it |
Inviter
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {invites} | Real invites they have now |
Room
| Variable | Gives you |
|---|---|
| {room} | The voice room (mention) |
| {room.name} | Room name |
| {room.id} | Room channel ID |
| {room.minutes} | Minutes it was open (when closed) |
Role
| Variable | Gives you |
|---|---|
| {role} | Mention of the role |
| {role.name} | Role name |
| {role.id} | Role ID |
Voice
| Variable | Gives 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
| Variable | Gives 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
| Variable | Gives 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
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {poll.question} | The question |
| {poll.answer} | The answer they voted for |
| {poll.answer_id} | Number of that answer |
Level
| Variable | Gives you |
|---|---|
| {level} | The new level |
Currency
| Variable | Gives you |
|---|---|
| {currency.name} | Currency name |
| {currency.emoji} | Currency emoji |
Daily
| Variable | Gives you |
|---|---|
| {result.amount} | What they got |
| {result.streak} | Days in a row |
| {result.balance} | Their balance now |
Item
| Variable | Gives you |
|---|---|
| {item.name} | Item name |
| {item.price} | Item price |
Case
| Variable | Gives you |
|---|---|
| {case.number} | Case number |
| {case.kind} | Case kind |
| {case.reason} | Case reason |
| {case.moderator} | Moderator (mention) |
Body
| Variable | Gives you |
|---|
Ticket
| Variable | Gives 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
| Variable | Gives 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
| Variable | Gives you |
|---|---|
| {giveaway.prize} | The prize |
| {giveaway.winners} | Every winner (mentions) |
| {giveaway.entries} | How many entered |
| {giveaway.url} | Link to the giveaway |
Suggestion
| Variable | Gives 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
| Variable | Gives 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
| Variable | Gives 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 |