Variables - Documentation

Variables allow you to inject dynamic data into your messages and embeds. They are automatically replaced by the bot based on the current context.

All variables are case-sensitive. Most variables follow the category.property format.

Variable	Output
`{user}`	Shortcut for the user’s global username.
`{user.id}`	The user’s unique Discord ID.
`{user.mention}`	Mentions the user (e.g., @adam).
`{user.name}`	The user’s global username or nickname.
`{user.tag}`	The user’s discriminator (e.g., 0001) or “0”.
`{user.avatar}`	URL to the user’s profile picture.
`{user.banner}`	URL to the user’s profile banner.
`{user.bot}`	Returns “Yes” or “No”.
`{user.created_at}`	Relative account age (e.g., “3 days ago”).
`{user.created_at_timestamp}`	Raw UNIX timestamp of account creation.
`{user.created_at_iso}`	ISO 8601 creation date.
`{user.created_at_date}`	YYYY-MM-DD format.
`{user.joined_at}`	Relative join time (Member context).
`{user.joined_at_timestamp}`	Raw UNIX timestamp of join date.
`{user.role_count}`	Total roles held by the member.
`{user.roles}`	List of mentions for all roles held.
`{user.nick}`	Server-specific nickname.

Variable	Output
`{guild.id}`	The server’s unique ID.
`{guild.name}`	The name of the server.
`{guild.mention}`	Text name of the server.
`{guild.count}`	Total member count.
`{guild.icon}`	URL to the server’s icon.
`{guild.owner}`	Mentions the server owner.
`{guild.owner_id}`	Discord ID of the owner.
`{guild.boost_count}`	Total number of server boosts.
`{guild.boost_tier}`	Current boost level (0-3).
`{guild.created_at}`	Relative age of the server.
`{guild.created_at_date}`	YYYY-MM-DD creation date.

Variable	Output
`{channel.id}`	The current channel’s ID.
`{channel.mention}`	Mentions the channel (e.g., #general).
`{channel.name}`	The name of the channel.
`{channel.topic}`	The channel’s topic/description.
`{channel.category_id}`	ID of the parent category.
`{channel.is_thread}`	Returns “Yes” or “No”.
`{channel.created_at}`	Relative creation time.

These are specifically available for Last.fm commands and custom FM embeds.

Variable	Output
`{track.name}`	Title of the current track.
`{track.url}`	Last.fm link to the track.
`{track.duration}`	Length of the track (MM:SS).
`{track.plays}`	Your total scrobbles for this track.
`{track.hyperlink_bold}`	Bold, clickable Markdown link for the track.
`{artist.name}`	Name of the artist.
`{artist.plays}`	Your total scrobbles for this artist.
`{artist.image}`	URL to the artist’s image.
`{album.name}`	Title of the album.
`{album.cover}`	URL to the album artwork.
`{user.plays}`	Your total Last.fm scrobbles.
`{scrobbles}`	Shortcut for total scrobbles.

Context	Variable	Output
Moderation	`{reason.value}`	The reason provided for the action.
Moderation	`{time.value}`	The duration of the punishment.
Levels	`{level}`	The user’s new level.
Tickets	`{ticket.number}`	Numeric ID of the ticket.
Tickets	`{ticket.topic}`	Selected topic for the ticket.
Messages	`{message.content}`	Content of the triggered message.
Messages	`{message.url}`	Direct link to the message.
System	`{timestamp}`	Discord localized full date/time.

Functional Variables

Convert any variable output to all lowercase letters.

In moderation or interaction contexts, use target_user to refer to the person being acted upon.