Quick Start
Role Picker works from the dashboard.
- 01
Open the Role Picker Page
Pick your server in the dashboard, choose Role Picker, then click Create Panel.
- 02
Choose a Channel, Style and Roles
Pick where the panel is posted, how members pick (buttons, a dropdown or a pop-up form) and the roles they can pick, each with a label.
- 03
Post It
Click Post Panel and Verifier posts it. Edit it later from the same page and click Save Changes to update the posted message. If the message was deleted, saving posts it again.
Settings
Change them on the Role Picker page in the dashboard, one panel at a time.
| Setting | What It Does | Default | Plan |
|---|---|---|---|
| Channel | Where the panel is posted. Verifier needs View Channel, Send Messages and Read Message History in it. Changing it moves the panel to the new channel. | Required | Free |
| Title and Description | The text above the buttons or dropdown. The title can be up to 100 characters and the description up to 1000. The title also heads the pop-up form. | None | Free |
| Style | Buttons: one button per role; clicking it again removes the role. Dropdown: members toggle roles from a menu. Pop-up form: one button opens a form with the member's current roles checked. Its label can be up to 80 characters and defaults to Select roles. | Buttons | Free |
| Component Position | Whether the buttons, dropdown or pop-up form button sit inside the embed or under it. Under it with no title, description or image, Verifier posts only the buttons or dropdown. | Inside | Free |
| Roles | The roles members can pick, each with a label of up to 80 characters, an optional emoji and an optional description of up to 100 characters, shown only in the dropdown and pop-up form. Custom emojis must be from this server. A role can appear once per panel. | Required, at least one | Free |
| Max Picks | How many of the panel's roles a member can hold at once, from 1 to the number of roles. Roles they already have count. With 1, picking another role with a button or the dropdown swaps it, unless Block role removal is on. | 1 | Free |
| Block Role Removal | Members keep the roles they pick and can't remove or swap them. | Off | Free |
| Remove Roles After | Picked roles are removed after 5, 10, 15, 30 or 45 minutes, 1, 2, 3, 6 or 12 hours, or 1, 3, 7, 14 or 30 days. Changing it only affects roles picked afterwards. | Never | Premium |
| Tell Members When Roles Expire | The reply after picking a temporary role says when it will be removed. | On | Free |
| Required Roles | Only members with at least one of these roles can use the panel. A required role can't also be offered by the same panel. Up to 25 roles. | Everyone | Premium |
| Accent Color | The color of the bar on the left of the panel message. | #5865F2 | Premium |
| Button Color | Green, blurple, grey or red. Applies to the Buttons and Pop-up form styles. | Grey | Premium |
| Dropdown Placeholder | The text shown in the dropdown before a member picks. Applies to the Dropdown style. Up to 150 characters. | Make a selection | Premium |
| Image | A direct link to a PNG, JPG, GIF or WebP image shown in the panel message. Discord attachment links expire, so use a permanent host. | None | Premium |
How It Works
When a member clicks a button, picks from the dropdown or submits the form, Verifier adds or removes the roles and replies with what changed. Only the member sees the reply. Each member can use a panel once every 2 seconds.
With the Dropdown style and Max picks above 1, Verifier asks before removing roles. Members choose Remove (Add and remove if they also picked new roles), Only add to keep their current roles, or Cancel. The question expires after 5 minutes.
Panels can't offer the everyone role, bot, booster or integration roles, or roles with moderator or admin permissions such as Manage Roles, Ban Members or Administrator. Each role must be below Verifier's highest role and below your own highest role, unless you own the server.
Free servers get 3 panels with up to 5 roles each. Premium raises this to 5 panels and 10 roles on Silver, 10 panels and 15 roles on Gold, and 15 panels and 25 roles on Diamond.
If the server's Premium ends or moves to a lower plan, panels that need more than the plan includes are paused: any panel using an option the plan lacks or holding more roles than it allows, plus the newest panels past the panel limit. Members who click a paused panel get a message instead of roles. Nothing is deleted. Renew, edit the panel to remove those options or delete panels to get back under the limit, and it works again. Roles members already picked stay, and timed roles still expire.
Timers belong to the role, not the panel. If a role is on a timed panel and a permanent one, members who pick it from the timed panel lose it when the time ends. The dashboard warns you about this.
Deleting a panel removes its message. Members keep their roles, and temporary ones are still removed on time.
Keep Verifier's Role Above the Panel Roles
Verifier can only give and remove roles below its own highest role. If you move a panel role above it, members get an error until you move Verifier's role back up.
Premium
Silver: more panels and roles, temporary roles, and the accent color, button color, dropdown placeholder and image. Gold: required roles.
Troubleshooting
Members get "Verifier cannot give these roles"
Verifier needs the Manage Roles permission, and its role must be above every role in the panel. Fix both in Server Settings › Roles.
A role is missing from the role list
The list leaves out the everyone role, bot, booster and integration roles, roles at or above Verifier's highest role, and roles already in this panel or set as required roles. Roles with moderator or admin permissions, or above your own highest role, are listed but can't be saved.
The panel wasn't posted
Verifier needs View Channel, Send Messages and Read Message History in the panel channel.
Members say they can't use the panel
Check Required roles. Members need at least one of them to use the panel.
Members get "These roles are no longer available"
A panel role was deleted, became a bot or integration role, or got moderator or admin permissions. Edit the panel and replace it.
A temporary role wasn't removed
When the time ends, Verifier needs Manage Roles and its role must still be above it, or the role stays. Roles picked before you set a time never expire.