Role Panels: Choose Roles Yourself with Buttons or a Dropdown

Role Panels are the modern self-service system for roles: you post a message with buttons or a dropdown, and members choose their roles with it. Unlike reaction roles, there is a single-choice group, a maximum of simultaneous roles, temporary roles and a level requirement per role.

Role Panels are also the role selection in onboarding. For a short walkthrough, see the guide Setting up Role Panels.

Requirements

• Access to the module: You sign in to the dashboard with Discord and need the Manage Server permission (or access granted for this module). The /rolepanel commands require the same permission.
• Roles in Discord: Create the roles that members should choose.
• Role order: Kage's role must be above these roles in the role list. Kage also needs Manage Roles (part of the standard invite).
• In the panel channel: Kage needs Send Messages and Embed Links.
• For level requirements: The level system should be on (Ranks, levels and rewards).

Creating a panel

In the dashboard under Role Panels, you click + Add panel and fill it in:

Then you proceed in two steps:

1. Save stores the configuration. For that, a panel needs a channel and at least one role option.
2. Post panel posts the message in the channel. Later, Update panel updates the same message instead of posting a new one. If it was deleted, Kage posts it again.

The message shows title, description and the role list with emoji. Behind a role it shows, if set, "from level N" and the duration in hours. A note in the footer names "single choice" or the maximum.

You can also manage the panels with commands (see below). The number of panels depends on the plan: Premium allows up to 15 panels, Enterprise up to 50. Existing panels above the limit are not trimmed; only further growth is blocked.

How a panel works

Buttons

• A click on a button toggles the role: if the member does not have it, they get it; if they have it, they lose it.
• With single choice, Kage removes the member's other panel roles when granting.
• If a maximum is set (without single choice) and reached, Kage refuses further roles and names the maximum.
• If the option has a level requirement and the member does not meet it, a message says which level is needed.

Dropdown

• The member chooses one or more roles. Kage reconciles the selection with the member's current roles: newly chosen roles are granted, deselected ones removed.
• With single choice only one selection is possible; otherwise at most as many as the maximum or the options allow.
• A role for which the level is missing is skipped here without its own message; you can recognize it by the "from level N" note in the list.

Temporary roles

If an option has temp. hrs, the role applies for only that many hours (1 to 8,760) and is then removed automatically. The time limit uses the same mechanism as Temporary roles. If the member removes the role themselves earlier, Kage deletes the time limit.

Replies

Kage replies only to the member (ephemeral): "➕" with the new roles and "➖" with the removed ones. If nothing changes, it says so. If Kage lacks the permission for a role, the member gets a corresponding message. Every change appears in the Logs tab.

The buttons and the dropdown also keep working after a bot restart. If the module is switched off or the panel is no longer in the configuration, Kage reports that the panel is no longer active.

Commands

The /rolepanel group can only be used with Manage Server. Only you see all replies.

With the command variant, at most 20 panels are possible.

Settings at a glance

Checking the result

1. Panel: Check that the message is in the channel and shows the buttons or the dropdown.
2. Test account: Click a role. You get "➕" with the role; a second click removes it.
3. Single choice and maximum: Check that the other roles are removed or that the limit applies.
4. Logs tab: Every change is noted there.

Troubleshooting

Nothing happens on click, or the role does not arrive

Usually it is the role order: Kage's role must be above the role, and Kage needs Manage Roles. The member then sees a message that Kage may not assign the role. Also check that the role still exists in Discord.

"Panel is not active"

"Role Panels enabled" is off, or the panel was removed from the configuration. Turn the module on and post the panel again.

The panel cannot be posted

First choose a channel and at least one role option, save, and then post. Check Kage's permissions in the channel.

A role is not granted although it was chosen

With the dropdown, the required level may be missing, or the maximum is reached. With buttons, a message appears for this.

A temporary role stays

Kage could not remove it on expiry (role order or permission). See Temporary roles.

Further reading

Roles on join: Auto roles. Roles by emoji: Reaction roles. Guided start: Onboarding.