community
Roles & Onboarding
Self-assignable role panels, welcome/goodbye messages, onboarding checklists, rules acknowledgement, and member verification (button, staff-approved modal, or CAPTCHA).
Disabled by default (opt-in)Requires the GuildMembers privileged intent
Self-serve roles, a real welcome mat, and a verification queue for gated servers.
Why gaming communities love it
- Game/platform/region self-assignable role panels let a 10,000-member hub sort itself into the right voice channels and pings without a single ticket.
- Welcome and goodbye messages with a live preview help a community feel staffed even when no moderator is online to say hello.
- Verification with staff approval keeps out account-farmed bots and ban-evaders before they can post — critical for servers running paid tournaments.
- Role persistence (clearly disclosed to admins) means a player who left mid-season and rejoins doesn't lose their team or rank role.
Full command reference
| Command | Description | Who can use it | Example |
|---|---|---|---|
/roles panel create | Create a new role panel (opens a form for the title/description). | Moderator+ | /roles panel create channel:#general style:"style" [group:"group"] [max-selections:10] |
/roles panel edit | Edit a role panel. | Moderator+ | /roles panel edit panel:"panel" [title:"title"] [description:"description"] [channel:#general] [style:"style"] [max-selections:10] |
/roles panel delete | Delete a role panel. | Moderator+ | /roles panel delete panel:"panel" |
/roles panel list | List this server's role panels. | Moderator+ | /roles panel list |
/roles panel post | Post (or repost) a panel to its channel. | Moderator+ | /roles panel post panel:"panel" |
/roles panel option-add | Add a role option to a panel. | Moderator+ | /roles panel option-add panel:"panel" role:@Moderators [label:"label"] [emoji:"emoji"] [description:"description"] |
/roles panel option-remove | Remove a role option from a panel. | Moderator+ | /roles panel option-remove panel:"panel" role:@Moderators |
/roles group create | Create a role group. | Moderator+ | /roles group create name:"name" [exclusive:true] [max-selections:10] [role1:@Moderators] [role2:@Moderators] [role3:@Moderators] [role4:@Moderators] [role5:@Moderators] |
/roles group edit | Edit a role group. | Moderator+ | /roles group edit group:"group" [name:"name"] [exclusive:true] [max-selections:10] [add-role:@Moderators] [remove-role:@Moderators] |
/roles group delete | Delete a role group. | Moderator+ | /roles group delete group:"group" |
/roles group list | List this server's role groups. | Moderator+ | /roles group list |
/roles persist on | Turn on role persistence (disclosed to admins). | Moderator+ | /roles persist on |
/roles persist off | Turn off role persistence. | Moderator+ | /roles persist off |
/roles persist status | Show whether role persistence is on. | Moderator+ | /roles persist status |
/roles autorole add | Add a role to the auto-role list (max 5 for humans, 3 for bots). | Moderator+ | /roles autorole add role:@Moderators [for:"for"] |
/roles autorole remove | Remove a role from the auto-role lists. | Moderator+ | /roles autorole remove role:@Moderators |
/roles autorole list | Show the current auto-role setup. | Moderator+ | /roles autorole list |
/roles autorole delay | Delay before auto-roles land (0 = immediately, max 7 days). | Moderator+ | /roles autorole delay seconds:10 |
/roles autorole enable | Turn auto-roles on or off. | Moderator+ | /roles autorole enable on:true |
/welcome set | Set the welcome channel/message. | Moderator+ | /welcome set [channel:#general] [message:"message"] [dm:true] |
/welcome embed | Build the welcome embed (opens a form). | Moderator+ | /welcome embed |
/welcome test | Send a preview of the welcome message. | Moderator+ | /welcome test [channel:#general] |
/welcome disable | Turn off welcome messages. | Moderator+ | /welcome disable |
/goodbye set | Set the goodbye channel/message. | Moderator+ | /goodbye set [channel:#general] [message:"message"] [dm:true] |
/goodbye embed | Build the goodbye embed (opens a form). | Moderator+ | /goodbye embed |
/goodbye test | Send a preview of the goodbye message. | Moderator+ | /goodbye test [channel:#general] |
/goodbye disable | Turn off goodbye messages. | Moderator+ | /goodbye disable |
/verify | Verify yourself to get access to the rest of the server. | Everyone | /verify |
/verification setup | Configure verification. | Moderator+ | /verification setup [mode:"mode"] [verified-role:@Moderators] [staff-channel:#general] [min-account-age-days:10] [underage-action:"underage-action"] [quarantine-role:@Moderators] [question1:"question1"] [question2:"question2"] [question3:"question3"] [question4:"question4"] [question5:"question5"] [clear-questions:true] |
/verification queue | List pending (modal-mode) verification requests. | Moderator+ | /verification queue |
/verification approve | Approve a pending verification request. | Moderator+ | /verification approve request:"request" |
/verification deny | Deny a pending verification request. | Moderator+ | /verification deny request:"request" [note:"note"] |
/onboarding checklist | See your onboarding progress. | Everyone | /onboarding checklist |
/onboarding config | Configure onboarding (staff only). | Everyone | /onboarding config [rules-text:"rules-text"] [rules-role:@Moderators] |
/onboarding rules-post | Post the rules with an "I agree" button (staff only). | Everyone | /onboarding rules-post channel:#general |
/onboarding step-add | Add a custom onboarding checklist step (staff only). | Everyone | /onboarding step-add id:"id" label:"label" |
/onboarding step-remove | Remove a custom onboarding step (staff only). | Everyone | /onboarding step-remove id:"id" |