K
Docs
API Reference→Pieces→Add Channel Picker
#️⃣

Add Channel Picker

ui.select.channelThe Control PanelControls

Adds a dropdown Discord fills with the server's channels, optionally narrowed to one kind. The chosen channel ID comes back as {{component.value}}.

When to use this
  • →Narrow to Text channels when the answer feeds a Send piece

On the canvas

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

#️⃣
Add Channel Picker
ui.select.channel
Controls
customIdrequired
pick_channel
placeholder
Choose a channel…
channelTypes
select…
minValues
1
maxValues
1
disabled
boolean…
output
error

Config fields

FieldTypeReqWhat it does
customId
pick_channel
textyesCustom id 🏷️
placeholder
Choose a channel…
text—Placeholder text 💬
channelTypesselect—Kinds to show 📡
minValues
1
number—Fewest they can pick 🔢
maxValues
1
number—Most they can pick 🔢
disabledboolean—Start greyed out 🚫

Output ports

outputChannel 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 ChannelSelectMenuBuilder()
  .setCustomId("pick_channel")
  .setChannelTypes(ChannelType.GuildVoice)
  .setPlaceholder("Choose a channel…");