Updated 2026-11-14 • 6 views

Levlix Auto Roles Guide

Auto Roles hands out roles without anyone pressing a button, and can announce it when a member receives a role. It covers three things:

  • a server tag role for members who wear your server tag,
  • a join role for every new member,
  • role announcements: a message with optional link buttons, posted whenever a member gains a role you picked.

Everything is configured in the Levlix Dashboard under Engagement → Auto Roles. There are no commands to run and no manual sync.

Note
Switch the module on first: open the Levlix Dashboard, pick your server and enable Auto Roles under Server → Modules.

Server tag role

Discord lets members adopt your server's tag next to their name. Pick a role under Server tag role in the Automatic roles card and Levlix keeps it in sync:

  • A member who adopts the tag receives the role right away.
  • A member who removes the tag, hides it, or switches to another server's tag loses the role again, but only if Levlix gave it to them. Members who got the role from a moderator or another bot keep it.
  • When you save the setting, members who already wear the tag are picked up by the next sync run, which happens every 15 minutes and on every bot start.

Pick a new role that is only meant for tag wearers. The server tag role and the join role must be two different roles.

Levlix remembers which members it gave the tag role to, so it never takes the role from anyone else. For a tag role that was set up before Levlix kept this record, the next sync run adds the current holders who wear the tag to that record, once. When you pick a different tag role or clear it, Levlix stops managing the old role and members keep it.

A sync run takes the role from at most 50 members. If more members dropped the tag, the rest follow in the next runs.

Note
Server tags are a Discord feature that has to be created in your server settings first. Until your server has a tag, the page shows a hint and a server tag role cannot be saved.

Join role

Pick a role under Join role and every new member receives it. If membership screening is enabled, the role is applied once the member accepts the rules; without screening it is applied immediately. Members who joined before you picked the role do not receive it. Bots never receive automatic roles.

Role announcements

Add an announcement for any role, up to 25 per server and one per role. Each one has:

Setting Description
Role The role that triggers the announcement
Channel The text channel the message is posted in
Enabled Switch an announcement off without deleting it
Title Optional headline, up to 100 characters
Message The message text, up to 2000 characters, supports the placeholders below
Accent colour Colour of the message container; defaults to the role colour
Link buttons Up to five buttons with label, link and optional emoji; links start with https:// or http://

The message also shows the member's avatar. Announcements fire no matter who granted the role: a moderator, the shop, level rewards, the server tag rule or the join rule. Bots never trigger an announcement.

Placeholders

Placeholder Result
{user} Mentions the member
{username} The member's username
{displayname} The member's display name
{server} The server name
{member_count} The current member count
{role} Mentions the role
{role_name} The role name

When Ping members in public announcements is off under Server → Settings, {user} names the member without notifying them.

Permissions and role hierarchy

Levlix needs Manage Roles for the server tag role and the join role, and View Channel and Send Messages in every announcement channel.

Levlix can only assign roles that sit below its own highest role. The pickers only offer those roles; to use a role that is missing, move the Levlix role above it in Server Settings → Roles. You can only pick a new role that you could hand out yourself, and a new announcement channel that you can post in yourself.

Without Manage Roles, Levlix pauses the server tag role and the join role. Once the permission is back, the next sync run catches up on the server tag role; members who joined in the meantime do not receive the join role afterwards.

Turning it off

Disable the module under Server → Modules in the dashboard sidebar. Roles that were already handed out stay on the members; Levlix stops adding, removing and announcing. It also forgets which members it gave the tag role to, so after switching the module back on it does not take the tag role from those members when they drop the tag.

Was this article helpful?

Thanks for your feedback! Your vote helps us improve the documentation.

Your vote could not be saved. Please reload the page and try again.

Share this guide

Your Privacy

We use essential cookies to operate this site and optionally Google Analytics to improve our services. You can accept all, reject all, or choose which categories you allow.

Privacy Policy

Cookie Preferences

Choose which categories of cookies you want to allow. You can change this at any time.

Essential Cookies

Required

Session, CSRF protection, login state.

Analytics Cookies

Optional

Google Analytics 4 with anonymized IP, used to understand aggregate usage.