Skip to content

Text formatting

Text formatting allows you to create powerful messages for different users and context and increase your audience range. It will replace some prefixed text with some dynamic text, for instance in Welcome service you can set a welcome message with text formatting to change the text based on the user who joined. e.g. Welcome {user} to {guild} with {memberCount} user/s Now the {user}, {guild}, {memberCount} variables will be replaced at runtime with the appropriate data. e.g. output Welcome Waterball to April Testing with 3 user/s.

You can use text formatting in any service that allow you to set custom message, you can use choose from the above tags and use them in the message. e.g. Welcome {user} in {guild}!! You're the {memberCount}th member. Ours server has been founded {guild.created.ago} and continuously increasing! All tags use curly brackets between the key so always make sure to use them, and they'll be replaced at runtime with the appropriate value.

Danger

This is a new feature is may not be available in every service and keep in mind that not every formatting are available to use some of them are only available for some type of service, for example {before.user} is not available on reaction role but only on logs

User

Tag Description Example output
{user} The User username Waterball
{user.mention} Mention the user @Waterball#0615
{user.discriminator} User discriminator 0615
{user.avatar} Avatar URL https://cdn.discordapp.com/avatars/195568671274434560/61a8612880d214e484cfe9756a724266.png
{user.fullname} Full name of the user Waterball#0615
{user.id} Id of the user 195568671274434560
{user.activity} User activity League of legend
{user.created} Full Date/time of when user has been created Thu, 23 Jun 2016 16:00:04 GMT
{user.created.date} Date of when user has been created 23.06.2016
{user.created.ago} Date/Time ago of when user has been created 3 years ago
{user.created.time} Full Date/time of when user joined 16:00
{user.joined} Full Date/time of when user joined Mon, 17 Jun 2019 19:23:01 GMT
{user.joined.date} Date of when user joined 17.06.2019
{user.joined.ago} Date/time ago of when user joined 10 days ago
{user.joined.time} Time of when user joined 13:12
{user.level} User level in the guild 2
{user.xp} User xp of the current level 300
{user.nextLevel} User xp needed for the next level 100
{user.totalXp} User total xp 600

Guild

Tag Description Example output
{guild} The server name April Testing
{memberCount} Members count 3
{memberCount.ordinal} Members count 3rd
{guild.id} The id of the guild 590166822196609024
{guild.created.date} Date of when guild has been created 17.06.2019
{guild.created.date} Date of when guild has been created 17.06.2019
{guild.created.time} Time of when guild has been created 15:40
{guild.icon} User activity https/cdn.discordapp.com/icons/321302816465485834/038225fd41246e93f6986fd23337ceb3.jpg

Channel

Tag Description Example output
{channel} Channel name general
{channel.id} id of the channel 591973650664783894
{channel.mention} Channel mention #general or <#general>
{channel.created.date} Date of when guild has been created 17.06.2019
{channel.created.date} Date of when guild has been created 17.06.2019
{channel.created.time} Time of when guild has been created 15:40
{channel.created.ago} Date/Time ago of when channel has been created 10 days ago
{channel.nsfw} Whether channel is NSFW or not True or false
{channel.topic} Topic of the channel This is the topic for my channel

Log

The below tags are special tags that can be used only on logs messages

Before user

Tag Description Example output
{before.user} User username Waterball
{before.user.discriminator} Discriminator of the user 0615
{before.user.nickname} Nickname of the user Water nick
{before.user.fullname} Full name of the user Waterball#0615
{before.user.activity} The activity of the user League of legends

After user

Tag Description Example output
{after.user} User username Water after
{after.user.discriminator} Discriminator of the user 0615
{after.user.nickname} Nickname of the user Water nick
{after.user.avatar} User avatar url https://cdn.discordapp.com/avatars/195568671274434560/61a8612880d214e484cfe9756a724266.png
{after.user.fullname} Full name of the user Waterball#0615
{after.user.activity} The activity of the user League of legends

Before channel

Tag Description Example output
{before.channel} Channel name general
{before.channel.id} Channel id 591973650664783894
{before.channel.nsfw} Is nsfw? False
{before.channel.topic} User avatar url Topic of the channel

After channel

Tag Description Example output
{after.channel} Channel name general
{after.channel.id} Channel id 591973650664783894
{after.channel.nsfw} Is nsfw? False
{after.channel.topic} User avatar url Topic of the channel
User Joined

Include all tags from guild and user, no extra tags are available

User Left

Include all tags from guild and user, no extra tags are available

User update username

Include all tags from guild, user, before user and after user

User update avatar

Include all tags from guild, user, before user and after user

User update discriminator

Include all tags from guild, user, before user and after user

Message delete

Include all tags from guild, user, channel and include {message} extra tag that contains the content of the message

Message update

Include all tags from guild, user, channel and include {before.message} that contains the previous content of the message and {after.message} that contains the modified content.

Voice moved

Include all tags from guild, user, channel, before channel and after channel

Voice Joined

Include all tags from guild, user, channel, before channel and after channel

Voice Left

Include all tags from guild, user, channel, before channel and after channel

User update nickname

Include all tags from guild, user, before user and after user

User remove nickname

Include all tags from guild, user, before user and after user

User add role

Include all tags from guild, user, before user and after user, include {roles} that contains the added roles

User add role

Include all tags from guild, user, before user and after user, include {roles} that contains the removed roles

Text channel created

Include all tags from guild and channel

Text channel destroyed

Include all tags from guild and channel

User banned

Include all tags from guild, user

User unbanned

Include all tags from guild, user

Voice channel created

Include all tags from guild and channel

Voice channel destroyed

Include all tags from guild and channel

Channel update

Include all tags from guild, channel, before channel and after channel

Twitch

Tag Description Example output
{stream.channel} Channel name April bot
{stream.avatarUrl} Profile picture URL Avatar url
{stream.url} Link to the channel https://twitch.tv...
{stream.viewerCount} Current viewers count 4242
{stream.started.ago} Start time ago 57 seconds ago
{stream.type} Stream type Live
{stream.title} Title of the stream My stream title
{stream.preview} Preview of the stream Preview url
{stream.length} Stream duration (offline message) 6h
{stream.game} Game being played League of Legends

YouTube

Tag Description Example output
{stream.channel.name} Title of the stream April bot
{stream.channel} Channel id UC...
{stream.url} Link to the channel youtube.com/...
{stream.started.ago} Publish/release date 57 seconds ago
{stream.title} video/live/premiere title My New Video