Automatic roles

Roles members get without asking — either automatically on join, or as a reward for doing something.

Autoroles

Roles handed out the moment someone joins.

!autorole add @Member

!autorole add @Member
!autorole add @Unverified

!autorole remove @Member

!autorole list

!autorole clear

Requires Manage Roles.

If your server has a membership screening rule (“Complete the rules screening”), members are technically in the server but pending before they accept. Autoroles apply after they accept, not on the initial join — which is the behaviour you want, but catches people out when testing.

Booster roles

Boosters get a personal role they name and colour themselves. It’s the single most reliable boost incentive.

For boosters

!boosterrole #ff5c8a

!boosterrole dominant

!boosterrole rename my role

!boosterrole icon 🌸
!boosterrole icon (attach an image)

!boosterrole remove

boosterrole dominant pulls the colour straight out of their avatar, which is the option most people end up using. Aliases for the group: color, br, cr.

!boosterrole share @friend
!boosterrole share list
!boosterrole share remove @Role
!boosterrole share clear

A booster can hand their custom role to other members. boosterrole share remove is what the recipient runs to drop a role they were given.

For admins

!boosterrole base @Booster

!boosterrole include @VIP
!boosterrole include list

!boosterrole share limit 3

!boosterrole sync

!boosterrole list

!boosterrole clear

boosterrole base sets the position new booster roles are created at, so they cluster in one place instead of scattering through your role list. boosterrole sync (alias organized) re-sorts existing ones and cleans up roles whose owner stopped boosting. Requires Manage Roles; clear requires Administrator.

Vanity roles

Reward members who put your server’s vanity URL in their custom status. Only available if your server has a vanity URL (level 3 boosts).

!vanity role @Advertiser

!vanity channel #general

!vanity message {content: thanks {user.mention} for repping us} {description: you got {role.mention}}

!vanity settings

!vanity reset

mira watches custom statuses. When someone’s contains your vanity — /mira or discord.gg/mira — they get the role. When they remove it, the role goes. Requires Manage Roles. Aliases: vr.

Server tag roles

Discord’s server tags feature lets members display a small server badge next to their name. This rewards them for using yours. Only available if your server has the tags feature enabled.

!tag role @Repping

!tag channel #general

!tag message {content: {user.mention} is repping the tag} {description: have {role.mention}}

!tag sync

!tag settings

tag sync scans the whole member list and grants the role to everyone already wearing the tag. Run it once after setting things up. Requires Administrator. Aliases: badge, servertag, guildtag.

Level roles

Roles granted at level milestones. Covered fully on the Levels page:

!level role add 10 @Regular
!level role add 25 @Veteran
!level role stack

Command reference

Command	Permission	Description
`autorole add <role>`	Manage Roles	Grant on join
`autorole remove <role>`	Manage Roles	Stop granting
`autorole list`	Manage Roles	View autoroles
`autorole clear`	Manage Roles	Remove all
`boosterrole <color>`	—	Create your booster role
`boosterrole dominant`	—	Colour from your avatar
`boosterrole rename <name>`	—	Rename it
`boosterrole icon [icon]`	—	Set an icon
`boosterrole remove`	—	Delete yours
`boosterrole share <member>`	—	Share with someone
`boosterrole share list`	—	Who has yours
`boosterrole base [position] <role>`	Manage Roles	Where booster roles sit
`boosterrole include <role>`	Manage Roles	Let a role create one
`boosterrole share limit <amount>`	Manage Roles	Cap sharing
`boosterrole sync`	Manage Roles	Reposition and clean up
`boosterrole list`	Manage Roles	All booster roles
`boosterrole clear`	Administrator	Delete them all
`vanity role <role>`	Manage Roles	Reward role
`vanity channel <channel>`	Manage Channels	Announcement channel
`vanity message <script>`	Manage Messages	Announcement text
`vanity settings`	Manage Server	View configuration
`vanity reset`	Manage Roles	Clear configuration
`tag role <role>`	Administrator	Reward role
`tag channel <channel>`	Administrator	Announcement channel
`tag message <script>`	Administrator	Announcement text
`tag sync`	Administrator	Backfill existing users
`tag settings`	Administrator	View configuration
`tag reset`	Administrator	Clear configuration

For roles members pick themselves, see Self-assignable roles. For moderator role commands — mass assignment, temp roles, role links — see Managing roles.

Start here

Security

Moderation

Server setup

Music & audio

Last.fm

Social

Utility

Automatic roles

Autoroles

Booster roles

For boosters

For admins

Vanity roles

Server tag roles

Level roles

Command reference

​Autoroles

​Booster roles

​For boosters

​Sharing

​For admins

​Vanity roles

​Server tag roles

​Level roles

​Command reference

Autoroles

Booster roles

For boosters

Sharing

For admins

Vanity roles

Server tag roles

Level roles

Command reference