Vanity Roles lets you reward members who support your server by adding your server invite link or a custom phrase (like discortics.com or .gg/myserver) to their Discord status.
When a member adds the text to a readable custom status, Discortics gives them your chosen roles. Changing to another nonempty status without the text removes the rewards. Offline or empty status keeps them.
Set up Vanity Roles
Set up from the DashboardConfigure reward roles, status keyword, log channels, and announcement messages.
- Make sure your server has an active Custom bot.
- In Discord Server Settings → Roles, move the Discortics role above the roles you want it to give.
- Open Dashboard → Settings.
- Expand Vanity Roles and turn on the toggle switch.
- (Optional) Choose reward roles. Leave this empty to use announcements alone.
- (Optional) Enter a Status Text / Watch Keyword to look for. If left blank, Discortics looks for your server's vanity invite code.
- (Optional) Select a Log Channel for status announcements. Role and everyone mentions are off by default.
- Use the save bar to apply the change.
[Insert screenshot here]
[insert screenshot here]
Before you begin
- Custom Bot Required: Tracking member custom statuses requires Discord's Presences feature, which is available exclusively on Custom bots.
- You need Manage Server to configure Vanity Roles.
- To award roles, Discortics needs Manage Roles and its role must be higher than the reward roles in the role list.
- Discortics needs View Channel, Send Messages, and Embed Links in the log channel.
How status matching works
Discortics checks a member's custom status whenever they update it:
- Server Vanity Link (Default): If you leave the keyword box blank, Discortics looks for your server's vanity invite code.
- Custom Keyword: If you enter text in the Status Text / Watch Keyword box, Discortics looks for that phrase instead (case-insensitive, e.g.
myserver.ggmatchesMyServer.GG).
Bot tier limits
| Feature | Free | Prime | Custom |
|---|---|---|---|
| Vanity Roles per server | 0 | 0 | 25 |
| Custom status keyword | ❌ | ❌ | ✅ |
| Custom announcement messages | ❌ | ❌ | ✅ |
Message variables
You can insert these placeholders into your announcement templates and Discortics will replace them automatically:
| Variable | What it shows |
|---|---|
{{user.mention}} | Mentions the member (e.g. @member) |
{{user.name}} | Member's username |
{{user.avatarURL}} | Member's profile picture URL |
{{server.name}} | Your server's name |
{{server.memberCount}} | Total number of members in your server |
{{vanity.statusText}} | The keyword or link being tracked |
{{vanity.status}} | The full status text on the member's profile |
Command reference
| Command | Purpose | Required user permission |
|---|---|---|
/settings vanity | Configure vanity reward roles, keyword, and logs | Manage Server |
Frequently asked questions
Why does Vanity Roles require a Custom bot?
Tracking Discord user presence updates across large servers requires dedicated bot resources and privileged Discord intents available only with a dedicated Custom bot instance.
Can I match multiple keywords?
Set the watch text to a shared phrase or domain (e.g. myserver). Discortics checks if the member's custom status contains the text anywhere in their status message.
What happens when a member removes the status text?
Discortics checks online, idle, and Do Not Disturb members with readable, nonempty custom-status text. If that text no longer matches for five seconds, configured reward roles are removed. Offline, invisible, hidden, null, and empty status retain perks. Clearing the status entirely therefore retains rewards until another nonempty status is observed.
Announcements follow confirmed status changes independently of reward roles. Initial observations stay silent; announcements can work without reward roles. Role failures do not block announcements, and message failures do not block role changes.
The dashboard lets you enable user, role, and everyone mentions separately for each template. Role and everyone mentions are off by default; saved opt-ins are respected.