Variables

Variables allow you to easily add information about the voter, bot, server and more into your custom vote embeds

Variable Formatting

Variables require lowercase letters and must be surrounded with {}.

Incorrect Variable Formatting

Missing {}
tag
Contains uppercase letters
{Tag}
Contains a space
{total votes}

Correct Variable Formatting

{tag}
{total_votes}

TagScript V1

TagScript V1 is now deprecated and will not work inside of Vote Messages anymore. If you notice tags not getting replaced, make sure to check its a TagScript V2 variable

Text Variables

The following variables are supported in all embed fields except image & field name & values. Please see below for a list of supported variables for images

NameDescriptionBotsServers

tag

Voters username & tag

id

Voters user ID

mention

Mentions the voter

total_votes

Voters total votes for the bot/server

monthly_votes

Voters votes for the bot/server this month

platform

Platform the bot/server was voted on

link

Link to vote for the bot/servre

date

Current date

role

Role given to voters

duration

Duration vote role is kept for

guild_name

Name of the voted or current server

guild_id

ID of the voted or current server

bot_name

Name of the voted bot

bot_mention

Mentions the voted bot

Image Variable List

The following variables are only supported for the author, footer & main image fields of the vote embed

NameDescriptionBotsServers

user_avtar

Voters icon

app_icon

Icon of the voted bot/server

TagScript V2

TagScript V2 is our current system for variables & dynamic content in messages. TagScript V1 only supported text variables and a few image variables, with inconsistent naming and formats. TagScript V2 fixes those issues

All V2 tags has a Top Level Tag, followed by a period (.) and then a property. This makes it much easier to see what a tag is for and gives access to many more tags

In addition to those improvements, TagScript V2 adds more types of tag: Colour, Link & Date tags. Some can be used with the existing setup commands & embed customisation in Discord, and some, such as link tags, will only be useful when customising the extra fields available in the Dashboard

Top Level Tags

Some Top Level Tags have replaced values, usually mentions, if no additional property is specified

TagDescriptionValue

voter

Contains information about the user who voted

<@760170825629958184>

guild

Contains information about the guild the tracker is setup in

app

Contains information about the bot that was voted for

<@959699003010871307>

platform

Contains information about the platform that the vote was on

rewards

Contains information about the rewards given

There are other top level tags for integration provided tags, for example miki contains information about the Miki EXP data that was given. You can find a list of tags for each Integration on their Discovery page

If a server was voted for, then any app tags will be replaced with nothing, or may not the replaced at all. The guild tag will always be replaced with the data of the server the vote message is to be sent in, even if the target was a bot

voter Properties

TagDescriptionValid For

id

ID of the voter

Text

username

Username of the voter

Text

global_name

Voter's global display name, falls back to username if not set

Text

display_name

Voter's nickname, or global_name if not set

Text

votes

Voter's total votes

Text

buckets:<id>

Number of votes in the bucket with the ID <id>, for example voter.buckets:monthly would be the number of votes in the defaut Monthly bucket

Text

created_at

Date voter's account was created on

TextDate

joined_at

Date the voter joined the server

TextDate

avatar_url

Voter's avatar

ImageLink

banner_url

Voter's banner

ImageLink

accent_color

Voter's profile accent colour. Will fallback to default embed if not set

Colour

banner_color

Voter's profile banner colour. Will fallback to default embed if not set

Colour

guild Properties

TagDescriptionValid For

id

ID of the server

Text

name

Name of the server

Text

created_at

Date server was created

TextDate

icon_url

Server icon

ImageLink

banner_url

Server banner

ImageLink

app Properties

TagDescriptionValid For

id

ID of the voted bot

Text

username

Name of the voted bot

Text

created_at

Date the voted bot was made

TextDate

joined_at

Date the voted bot joined the server

TextDate

avatar_url

Avatar of the voted bot

ImageLink

platform Properties

TagDescriptionValid For

name

Name of the platform voted on

Text

next_vote.hours

Relative time until the user can vote (e.g. in 6 hours)

Text

next_vote

Time when the user is next able to vote

TextDate

url

Link to the platform

TextLink

view_url

Link to the bot/servers page on the platform

TextLink

vote_url

Link to vote on the platform

TextLink

icon_url

Platform's icon/logo

ImageLink

The platform.next_vote and platform.next_vote.hours tags are only supported in message content, embed field values, embed descriptions and embed timestamps due to a limitation of Discord's formatting. Using these tags in other fields will cuase unexpected formatting

rewards Properties

TagDescriptionValid For

role

Mention the primary reward role

Text

role.id

ID of the primary reward role

Text

role.name

Name of the primary reward role

Text

role.duration

Duration primary reward role is kept for

Text

role.color

Color of the primary reward role

Colour

miki Properties

TagDescriptionValid For

bucket

Bucket that given EXP is in

Text

exp

Amount of EXP given to voter

Text

levelled_up

If the user has levelled up

Text

Additional Tags

These tags have no Top Levels Tags and are used as just {tag}

TagDescriptionValid For

date

Current date

TextDate

monthly_votes

Voter's votes in the monthly bucket.

Text

{monthly_votes} has been deprecated and may be removed in a future update. You should use the tag {voter.buckets:monthly} instead

Last updated