Create a role panel

Post buttons members click to give themselves roles, like colours, pronouns or ping roles.

  • About 4 minutes
  • In Discord
  • 6 steps

Before you start

  • Administrator
  • The roles you want to offer, below Element's own role

Create the panel

Run /rolepanel create with a panel_name of 2 to 14 characters, like colours. You use the name in every other role panel command.

New panels start as buttons in toggle mode: clicking a role gives it, and clicking again takes it away.

staff

Commands matching /rolepanel

  • /rolepanel createCreate a new role panel.APP
  • /rolepanel viewView and manage a role panel in-place.APP
/rolepanel createpanel_name:colours

Add the roles

Run /rolepanel view with the panel's name to open its menu, then click Roles and Add Role.

For each role you can set a label (what the button says), an emoji, and a button colour. A panel holds up to 25 roles, and Arrange changes their order.

staff
RRayyanused/rolepanel view
ElementAPPToday at 18:04

Manage this role panel:

NameTypeAuto-enforceEmbed
ClickRolesWhitelistBlacklist

Pick how clicks work

Click Type to choose Buttons or Select (a dropdown), and the Mode:

  • Toggle gives a role or takes it away.
  • Add only never takes roles away, and Remove only never gives them.
  • Single keeps one role from the panel at a time, which suits colour roles.

Role Panel Type

Type

Buttons

Mode

Single
CancelSubmit

Write the message

Click Embed to write the message above the buttons. {autofill(...)} repeats a line for every role on the panel: the default, {autofill({emoji}: {role(mention)})}, lists each role with its emoji.

Click View Formatted in the embed menu to preview it.

roles
ElementAPPToday at 18:04

Pick a colour

🔴: @Red

🟢: @Green

🔵: @Blue

🔴 Red🟢 Green🔵 Blue

Post it

Run /rolepanel send default with the panel's name, and a channel if it isn't the one you're in. Members can use it straight away.

Want it to come from a custom name and avatar? Use /rolepanel send webhook instead.

roles

Commands matching /rolepanel send

  • /rolepanel send defaultSend a role panel using the bot user.APP
  • /rolepanel send webhookSend a role panel via a guild webhook.APP
/rolepanel send defaultpanel_name:colours

Limit who can use it

In the panel's menu, Whitelist roles are required: members need at least one to use the panel. Blacklist roles are refused: anyone with one is turned away. Each holds up to 25 roles.

Changed the panel after posting it? Run /rolepanel edit with the posted message's ID to update it in place.

staff

Commands matching /rolepanel edit

  • /rolepanel editEdit an existing role panel message by message ID.APP
/rolepanel editmessage_id:1290031542869811240panel_name:colours

1/6