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 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.

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 these fixes and 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

Tag	Description	Value
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

Tag	Description	Valid 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

Tag	Description	Valid 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

Tag	Description	Valid 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

Tag	Description	Valid 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 and embed fields, descriptions & timestamps due to a limitation of Discord's formatting. Using these tags in other fields will cuase unexpected formatting

rewards Properties

Tag	Description	Valid 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

Tag	Description	Valid 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}

Tag	Description	Valid 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

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

Name	Description	Bots	Servers
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

Name	Description	Bots	Servers
user_avtar	Voters icon
app_icon	Icon of the voted bot/server