Role Panels
Let your community self-assign roles by clicking buttons. Create panels from templates or scratch, pick existing roles or ask Arkanis to create them, and post to any channel with a single click.
Open Role Panels →What is this?
A panel of self-service role buttons that members click to give or remove their own roles. Build from one of six presets (platform, color, pronouns, notifications, region, blank) or from scratch. Pick or auto-create roles, design the embed, and post to any channel.
Why you might want it
So you can stop being the role-assignment middleman. New members pick their platform, their pronouns, and their notification preferences without ever needing a moderator. The platform preset is the most-used: PC, PlayStation, Xbox, Switch roles in two clicks for the member and zero clicks for staff.
Open the Role Panel Editor
Navigate to Moderation Panel
From the dashboard sidebar, click Moderation Panel. Existing role panels appear as compact preview cards in the Role Panels section. Click Create Role Panel in the top-right to launch the wizard.
Choose a Template
The wizard opens with six starting points. Templates pre-fill the embed and add suggested roles; you can customize everything afterwards.
- Platform Roles — PC, PlayStation, Xbox, Switch role buttons
- Color Roles — Cosmetic name-color options
- Pronouns — he/him, she/her, they/them, and more
- Notifications — Opt-in roles for announcements, events, giveaways
- Region — Geographic regions for matchmaking and scheduling
- Start from Scratch — A blank canvas
Design the Embed
Pick a Channel
Open the Channel dropdown and choose where the panel will be posted. This is required.
Set Title and Color
Enter a clear title (max 256 characters; a live counter is shown) and pick an accent color. You can click any of the preset swatches, use the full color picker, or paste a hex code.
Add a Description
Optional but recommended. Use the description to tell users what the buttons do, for example: "Click a button to toggle that role on or off. Click again to remove it." Discord markdown is supported.
Footer, Thumbnail, and Image
Free servers get the default footer Guild • Powered by Arkanis; Pro servers can set a custom footer. Optionally add a thumbnail URL (top-right of the embed) or image URL (below the description).
Add Roles
Click Add Role
In the Roles section, click Add Role to add a row. Free servers can add up to 5 roles per panel; Pro servers can add up to 25.
Pick or Create the Role
Each role row has a selector with two modes:
- Select existing role — Choose a role your server already has from the dropdown
- Create new role — Enter a custom name; the bot will create the role automatically when you submit the panel
Configure the Button
For each role, pick:
- Emoji — Max 10 characters (Unicode or custom server emoji)
- Button Style — Blue, Gray, Green, or Red
Drag role rows to reorder them; the button order in Discord matches the row order in the editor.
Review & Post
Check the Live Preview
The right side of the wizard shows a real-time preview of the embed and all role buttons. Every change updates immediately so you can confirm the layout before submitting.
Validation
The submit button stays disabled until you've provided a channel, a title, and at least one role. Each role must have either an existing roleId selected or the createRole flag set with a name.
Submit
Click Create Panel. The bot creates any new Discord roles you configured, posts the embed and buttons to the chosen channel, and shows the toast "Role panel created". Users can immediately click buttons to self-assign.
How Role Toggling Works
Click to Toggle
When a user clicks a role button, the bot checks whether they have the role:
- If they don't have the role, it's added
- If they already have the role, it's removed
A short ephemeral confirmation appears each time so the user sees their action landed. A 1-second per-user cooldown prevents double-click spam.
Edit a Role Panel
Open the Panel List
Navigate to Moderation Panel in the dashboard sidebar and click an existing role panel card. The editor opens pre-populated with the panel's current configuration.
Modify Anything
Change the embed title, description, color, or images. Add or remove roles. Change button emojis, styles, or the underlying Discord role. Drag-to-reorder row ordering. Save to update the existing Discord message in place.
Delete a Role Panel
Start the Delete Flow
From Moderation Panel in the dashboard sidebar, click Delete Role Panel. A dialog appears with a dropdown listing every role panel formatted as {title} ({count} roles).
Pick the Panel and Confirm
Select the panel from the dropdown. A confirmation dialog appears with the message: "Delete role panel? This will permanently remove the role panel and delete its message from Discord. Users will no longer be able to self-assign these roles."