Variables

Complete list of template and ticket name variables.

Template and ticket variables use the syntax ${dotted.path}. Some variables accept a #argument suffix.

Scopes

ScopeWhen available
Assistance (assistance)Always available — info about the bot and this template.
Server (guild)Available when sent to a server. Invalid in DMs.
Triggered By (triggeredBy)The user who triggered this message (button click, ticket, …).
Ticket (ticket)Available on ticket panel creation templates.
Random (random)Generated fresh on each send — unique IDs and random numbers.

Automation metadata

Custom automation variables use ${metadata.key} syntax. Keys are declared on Dictionary nodes. See Automation metadata.

Assistance

Always available — info about the bot and this template.

TokenLabelDescription
${assistance.version}Bot VersionThe current Assistance version.
${assistance.templateId}Template IDThe ID of this template.
${assistance.templateName}Template NameThe name of this template.
${assistance.isDMs#Yes:No}In DMs?Shows different text depending on whether this is a DM. Arg: Yes:No
${assistance.emojis#EmojiName}Assistance EmojiA built-in Assistance emoji by name. Arg: EmojiName

Server

Available when sent to a server. Invalid in DMs.

TokenLabelDescription
${guild.id}Server IDThe server's Discord ID.
${guild.assistanceId}Internal Server IDThe internal Assistance ID for this server.
${guild.slug}Server SlugThe server's Assistance slug.
${guild.memberCount}Member CountTotal members, including bots (e.g. 4,259).
${guild.botCount}Bot CountNumber of bots in the server.
${guild.userCount}User CountNumber of humans (non-bots) in the server.
${guild.icon}Server IconThe server icon URL.
${guild.emojis#EmojiName}Server EmojiA custom server emoji by name. Arg: EmojiName

Triggered By

The user who triggered this message (button click, ticket, …).

TokenLabelDescription
${triggeredBy.userId}User IDUser's Discord user ID.
${triggeredBy.ping}User MentionMentions User (<@id>).
${triggeredBy.profilePicture}User AvatarUser's profile picture URL.
${triggeredBy.username}User UsernameUser's account username.
${triggeredBy.nickname}User NicknameUser's server nickname.
${triggeredBy.displayName}User Display NameUser's Discord-wide display name.
${triggeredBy.highestRole}User Highest RoleThe name of User's highest role.
${triggeredBy.highestRole.ping}User Highest Role MentionMentions User's highest role.
${triggeredBy.roleCount}User Role CountThe number of roles User has.
${triggeredBy.links.roblox.isVerified#Yes:No}User Roblox Verified?Shows different text depending on whether User has a verified Roblox account. Arg: Yes:No
${triggeredBy.links.roblox.userId}User Roblox IDUser's verified Roblox user ID.
${triggeredBy.links.roblox.username}User Roblox UsernameUser's verified Roblox username.
${triggeredBy.links.roblox.displayName}User Roblox Display NameUser's verified Roblox display name.
${triggeredBy.links.roblox.profileUrl}User Roblox ProfileA link to User's verified Roblox profile.

Ticket

Available on ticket panel creation templates.

TokenLabelDescription
${ticket.id}Ticket IDThe ticket's ID.
${ticket.status#Open:Claimed:Closed}Ticket StatusShows different text per ticket status. Arg: Open:Claimed:Closed
${ticket.createdAt#f}Ticket Created AtWhen the ticket was created (Discord timestamp). Arg: f
${ticket.channel}Ticket ChannelMentions the ticket's channel.
${ticket.panel.id}Panel IDThe ticket panel's ID.
${ticket.panel.name}Panel NameThe ticket panel's name.
${ticket.panel.category}Panel CategoryMentions the panel's category channel.
${ticket.panel.categoryId}Panel Category IDThe panel's category channel ID.
${ticket.panel.archiveChannel}Panel Archive ChannelMentions the panel's archive channel.
${ticket.panel.archiveChannelId}Panel Archive Channel IDThe panel's archive channel ID.
${ticket.panel.supportRoles}Support RolesThe roles that can claim and manage this ticket, as a list of mentions.
${ticket.panel.requiredRoles}Required RolesThe roles required to open a ticket on this panel, as a list of mentions. Empty when anyone can open one.
${ticket.createdBy.userId}Creator IDCreator's Discord user ID.
${ticket.createdBy.ping}Creator MentionMentions Creator (<@id>).
${ticket.createdBy.profilePicture}Creator AvatarCreator's profile picture URL.
${ticket.createdBy.username}Creator UsernameCreator's account username.
${ticket.createdBy.nickname}Creator NicknameCreator's server nickname.
${ticket.createdBy.displayName}Creator Display NameCreator's Discord-wide display name.
${ticket.createdBy.highestRole}Creator Highest RoleThe name of Creator's highest role.
${ticket.createdBy.highestRole.ping}Creator Highest Role MentionMentions Creator's highest role.
${ticket.createdBy.roleCount}Creator Role CountThe number of roles Creator has.
${ticket.createdBy.links.roblox.isVerified#Yes:No}Creator Roblox Verified?Shows different text depending on whether Creator has a verified Roblox account. Arg: Yes:No
${ticket.createdBy.links.roblox.userId}Creator Roblox IDCreator's verified Roblox user ID.
${ticket.createdBy.links.roblox.username}Creator Roblox UsernameCreator's verified Roblox username.
${ticket.createdBy.links.roblox.displayName}Creator Roblox Display NameCreator's verified Roblox display name.
${ticket.createdBy.links.roblox.profileUrl}Creator Roblox ProfileA link to Creator's verified Roblox profile.
${ticket.claimedBy.userId}Claimer IDClaimer's Discord user ID.
${ticket.claimedBy.ping}Claimer MentionMentions Claimer (<@id>).
${ticket.claimedBy.profilePicture}Claimer AvatarClaimer's profile picture URL.
${ticket.claimedBy.username}Claimer UsernameClaimer's account username.
${ticket.claimedBy.nickname}Claimer NicknameClaimer's server nickname.
${ticket.claimedBy.displayName}Claimer Display NameClaimer's Discord-wide display name.
${ticket.claimedBy.highestRole}Claimer Highest RoleThe name of Claimer's highest role.
${ticket.claimedBy.highestRole.ping}Claimer Highest Role MentionMentions Claimer's highest role.
${ticket.claimedBy.roleCount}Claimer Role CountThe number of roles Claimer has.
${ticket.claimedBy.links.roblox.isVerified#Yes:No}Claimer Roblox Verified?Shows different text depending on whether Claimer has a verified Roblox account. Arg: Yes:No
${ticket.claimedBy.links.roblox.userId}Claimer Roblox IDClaimer's verified Roblox user ID.
${ticket.claimedBy.links.roblox.username}Claimer Roblox UsernameClaimer's verified Roblox username.
${ticket.claimedBy.links.roblox.displayName}Claimer Roblox Display NameClaimer's verified Roblox display name.
${ticket.claimedBy.links.roblox.profileUrl}Claimer Roblox ProfileA link to Claimer's verified Roblox profile.

Random

Generated fresh on each send — unique IDs and random numbers.

TokenLabelDescription
${random.uuid}Random UUIDA random UUID v4, e.g. 550e8400-e29b-41d4-a716-446655440000.
${random.nanoid#length}Random NanoIDA random URL-safe ID. Optionally specify the length (default 24, max 100). Arg: length
${random.number#MIN:MAX}Random NumberA random integer between 0 and 99, or a custom MIN–MAX range. Arg: MIN:MAX
${random.snowflake}Random SnowflakeA random Discord-style snowflake ID as text.

How is this guide?

On this page