Vanity Roles

What are vanity roles?

A vanity role is what a member gets for putting your server on their profile. There are two ways to earn one, and you can run either, both, or neither:

• Status — their custom status contains a text you choose, like /serenity.
• Guild tag — they wear your server's tag next to their name.

Serenity watches for both and hands out the roles the moment someone qualifies, then takes them back when they stop.

Status vanity

Setting the trigger text

Whatever you set here is searched for anywhere inside a member's custom status, case-insensitively. A member with hi im in /serenity btw matches /serenity.

Syntax: /vanity code [text]
Example: /vanity code /serenity

Choosing the roles

You can grant several roles at once. Separate them with commas — mentions, IDs and names all work.

Syntax: /vanity role add [roles]
Example: /vanity role add Vanity, Repper

Removing works the same way:

Syntax: /vanity role remove [roles]
Example: /vanity role remove Repper

Strict mode

By default, a member who goes offline keeps the role. Their status isn't readable while they're offline, and treating that as "they stopped repping" would strip the role off everyone who's asleep.

Strict mode changes that: the roles come off the instant a member goes offline.

Syntax: /vanity strict [on/off]
Example: /vanity strict on

Guild tag

Discord's guild tags are the second thing a member can rep your server with, and this rewards them for it. Unlike a status, a tag can't be typed by accident and stays visible while the member is offline.

Turning it on

Syntax: /vanity tag enable [on/off]
Example: /vanity tag enable on

That's the whole setup for most servers. With nothing else configured, tag reppers get the same roles, log channel and embeds as the status vanity — everything below is an optional override.

Giving the tag its own roles

If you'd rather tell tag reppers apart from status reppers, give the tag its own role list. As long as this list is empty, the tag shares the vanity roles.

Syntax: /vanity tag role [add/remove] [roles]
Example: /vanity tag role add Tag Gang

Emptying the list again puts it back to sharing the vanity roles.

Tracking a different server's tag

By default the bot looks for this server's tag. If you run a network of servers that share one tag, point it at the server the tag belongs to:

Syntax: /vanity tag server [server id]
Example: /vanity tag server 1047121610622111806

Leave the ID out to go back to your own tag.

Logging

Where events go

Set a channel and every grant and revoke is announced in it. Leave the channel out to switch logging off again.

Syntax: /vanity logs channel [channel]
Example: /vanity logs channel #vanity-log

Tag events go to the same channel unless you give them one of their own:

Syntax: /vanity tag logs [channel]
Example: /vanity tag logs #tag-log

Custom embeds

The default log message is a plain one-liner. You can replace it with your own using embed code:

/vanity logs embed grant {embed}$v{description: {user.mention} earned the vanity role}
/vanity logs embed revoke {embed}$v{description: {user.mention} lost the vanity role}

And, if you want tag events worded differently:

/vanity tag embed grant {embed}$v{description: {user.mention} is repping the tag}

Run /vanity tag embed with no script to clear the override and go back to the vanity embed.

Checking your setup

Both halves have a status command that shows exactly what's configured, which roles are still valid, and where events are being logged.

/vanity status
/vanity tag status

Customizing the bot

customize is the same donor perk you already have on the main bot — a per-server avatar, banner and bio. The vanity bot carries its own copy, so you can brand it separately from the main one instead of both wearing the same face.

Syntax: /customize avatar [image]
Syntax: /customize banner [image]
Syntax: /customize bio [text]

Command reference

Common questions

Last edited 4 minutes ago