Role panels
Post buttons or a dropdown that members use to give themselves roles, with rules for who can pick what.
- Dashboard
- Dashboard › Role panels
- Commands
/rolepanel (or e!rp)- You need
- Administrator
- Element needs
- Manage Roles (with its role above the panel's roles), View Channel, Send Messages and Embed Links. Manage Webhooks to post or edit through a webhook.
- Plans
- More panels. Auto-enforce needs the Premium plan. See plans
What it does
A role panel is a message with a button for each role, or a dropdown menu, under an embed you design. Members click to give themselves a role, or take it away, without asking staff.
Each panel has a mode that decides what a click does:
| Mode | A click on a role… |
|---|---|
| Toggle | gives it, or takes it away if they have it |
| Add only | gives it, and never takes it away |
| Remove only | takes it away, and never gives it |
| Single | gives it and takes away the panel's other roles, so members hold one at a time |
Whitelist and blacklist roles decide who can use a panel: with a whitelist, members need at least one of its roles; anyone with a blacklisted role is turned away.
Why use it
Colour roles, pronouns, ping roles for announcements or events, game and region roles: anything members should choose for themselves. One panel replaces dozens of "can I have the role?" messages.
Set it up
- Open the dashboard, pick your server and go to Role panels.
- Click New role panel, add roles under Roles, and pick Show roles as and the Mode. Who can use it sets the allowed and blocked roles.
- Write the message above the roles, save, and post the panel in a channel. The preview shows what members will see.
/rolepanel createwith a panel_name of 2 to 14 characters./rolepanel viewwith the name opens the panel's menu. Add roles with Roles, and set the embed, type, mode and rules./rolepanel send defaultposts it in the current channel, or the channel you pick.
The role panel guide walks through the commands step by step.
New panels start as buttons in toggle mode with a simple embed.
Commands
| Command | What it does |
|---|---|
/rolepanel create | Create a panel |
/rolepanel view | Open a panel's menu to change it |
/rolepanel list | List the server's panels |
/rolepanel send default | Post a panel as Element |
/rolepanel send webhook | Post a panel through a webhook, with your own name and avatar |
/rolepanel edit | Update a panel you already posted, by its message ID, after changing it |
/rolepanel delete | Delete a panel |
Every command needs Administrator.
Customise it
From /rolepanel view:
- Name, Type (buttons or select) and Mode.
- Embed sets the message above the buttons. Put
{autofill(...)}in it to repeat a line for every role: the default,{autofill({emoji}: {role(mention)})}, lists each role's emoji and mention.{role}also takesnameorid. View Formatted previews it. - Roles adds, edits, removes and arranges roles. Each role has a label (up to 80 characters), an emoji, and a button colour or a dropdown description. A panel holds up to 25 roles.
- Whitelist and Blacklist hold up to 25 roles each.
- Auto-enforce takes a panel role away when its holder stops meeting the whitelist or gains a blacklisted role.
Limits
| Free | Basic | Premium | |
|---|---|---|---|
| Role panels | 10 | 25 | 50 |
| Roles per panel | 25 | 25 | 25 |
Common problems
- "Cannot add … role grants dangerous permissions". Element never hands out roles with permissions like Administrator, Manage Server or Ban Members from a panel.
- The role isn't given. Element's role must be above it, and Element needs Manage Roles.
- "Role no longer exists" or "This role is no longer linked to any panel". The role or panel was deleted. Update the panel and post it again, or use
/rolepanel edit. - Changes don't show on the posted panel. Posted panels don't update themselves. Run
/rolepanel editwith the message ID to refresh it.
Turn it off or reset it
Delete the panel's message to hide it, or /rolepanel delete to remove the panel. Members keep the roles they already picked.