Docs / Bot

Role Selector

Allows members to self-assign roles via selection options. You can set a title and description for each role option, as well as apply multiple roles within a single option. Unlike Discord's native Onboarding custom questions, Role Selector can re-synchronize role assignments for all members who have previously chosen a specific option whenever you update that option's settings.

Role Selector Editor

After creating a Role Selector, the bot will send an ephemeral message (visible only to you) containing the Role Selector Editor. Interacting with this message provides an intuitive way to edit each option and configure the selector settings.

ButtonDescription
New OptionCreate a new option (up to 25 options)
Edit OptionEdit a specified option
Move OptionReorder the sequence of options
Delete OptionDelete a specified option
Synced x MembersIf you modify the role settings for an option, you can choose whether to sync the updated role settings for all members who have already selected this option
Edit ContentEdit the text content displayed by the Role Selector
SendSend to specified channels (up to 25 channels simultaneously)
RenameRename the current Role Selector
DeleteDelete the current Role Selector; all previously sent Role Selector messages will also be deleted
RefreshRefresh the information in the Role Selector Editor

Create Role Selector /role-selector create

Use this command to create a Role Selector.

Command Parameters

ParameterTypeRequiredDescription
nameTextNoYou can set a name for this role selector for identification; defaults to Untitled

Edit Role Selector /role-selector edit

Use this command to bring up the Role Selector Editor.

Command Parameters

ParameterTypeRequiredDescription
nameTextYesSelect the name of the Role Selector you want to edit

Delete Role Selector /role-selector delete

Use this command to delete a specified Role Selector. All previously sent Role Selector messages will also be deleted.

Command Parameters

ParameterTypeRequiredDescription
nameTextYesSelect the name of the Role Selector you want to delete