A Channel Select is an interactive component that allows users to select one or more channels in a message. Options are automatically populated based on available channels in the server and can be filtered by channel types.

Channel Selects can be configured for both single-select and multi-select behavior. When a user finishes making their choice(s) your app receives an interaction.

Channel Selects must be placed inside an Action Row and are only available in messages. An Action Row can contain only one select menu and cannot contain buttons if it has a select menu.

interface APIChannelSelectComponent {
    channel_types?: ChannelType[];
    custom_id: string;
    default_values?: APISelectMenuDefaultValue<Channel>[];
    disabled?: boolean;
    id?: number;
    max_values?: number;
    min_values?: number;
    placeholder?: string;
    required?: boolean;
    type: ChannelSelect;
}

Hierarchy (View Summary)

Properties

channel_types?: ChannelType[]

List of channel types to include in the ChannelSelect component

custom_id: string

A developer-defined identifier for the select menu, max 100 characters

List of default values for auto-populated select menu components

disabled?: boolean

Disable the select

false

id?: number

32 bit integer used as an optional identifier for component

The id field is optional and is used to identify components in the response from an interaction that aren't interactive components. The id must be unique within the message and is generated sequentially if left empty. Generation of ids won't use another id that exists in the message if you have one defined for another component.

max_values?: number

The maximum number of items that can be chosen; max 25

1

min_values?: number

The minimum number of items that must be chosen; min 0, max 25

1

placeholder?: string

Custom placeholder text if nothing is selected, max 150 characters

required?: boolean

Whether the component is required to answer in a modal.

true

The type of the component