K
Docs
API Reference→Pieces→Add Role Picker
🎭

Add Role Picker

ui.select.roleThe Control PanelControls

Adds a dropdown Discord fills with the server's roles. The chosen role ID comes back as {{component.value}} — perfect for self-serve role menus.

When to use this
  • →Feed {{component.value}} straight into Add Role for a self-serve role menu

On the canvas

This is what Add Role Picker looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

🎭
Add Role Picker
ui.select.role
Controls
customIdrequired
pick_role
placeholder
Choose a role…
minValues
1
maxValues
1
disabled
boolean…
output
error

Config fields

FieldTypeReqWhat it does
customId
pick_role
textyesCustom id 🏷️
placeholder
Choose a role…
text—Placeholder text 💬
minValues
1
number—Fewest they can pick 🔢
maxValues
1
number—Most they can pick 🔢
disabledboolean—Start greyed out 🚫

Output ports

outputRole picker staged
errorMissing a custom id
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
const menu = new RoleSelectMenuBuilder()
  .setCustomId("pick_role")
  .setPlaceholder("Choose a role…");