Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/change-log/2025-09-10-more-modal-components.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: "Adding More Modal Components!"
date: "2025-09-10"
topics:
- "Interactions"
- "Components"
---

We've added more components to modals! All select menus (User, Role, Mentionable, Channel) are now fully supported in modals. In order to use a select menu in a modal, it must be placed inside a [Label](/docs/components/reference#label) component. We've also added the [Text Display](/docs/components/reference#text-display) component with markdown support as a top-level component in modals.

#### Components Now Supported in Modals:

- [**User Select**](/docs/components/reference#user-select)
- [**Role Select**](/docs/components/reference#role-select)
- [**Mentionable Select**](/docs/components/reference#mentionable-select)
- [**Channel Select**](/docs/components/reference#channel-select)
- [**Text Display**](/docs/components/reference#text-display)

#### Getting Started

- [Using Modal Components](/docs/components/using-modal-components) - Dive into creating a modal

#### Developer Resources

Check out our [Component Reference](/docs/components/reference) for details on all available components.
627 changes: 574 additions & 53 deletions docs/components/reference.mdx

Large diffs are not rendered by default.

22 changes: 14 additions & 8 deletions docs/interactions/receiving-and-responding.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,17 +127,23 @@ Sent in `APPLICATION_COMMAND` and `APPLICATION_COMMAND_AUTOCOMPLETE` interaction

###### Modal Submit Data Structure

| Field | Type | Description |
|------------|-----------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| custom_id | string | The custom ID provided for the modal |
| components | array of [modal submit component data](/docs/interactions/receiving-and-responding#interaction-response-object-modal) | Values submitted by the user |
| Field | Type | Description |
|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| custom_id | string | The custom ID provided for the modal |
| components | array of [component interaction response](/docs/interactions/receiving-and-responding#interaction-object-component-interaction-response-structures) | Values submitted by the user |

###### Component Interaction Response Structures

| Component |
|--------------------------------------------------------------------------------------------------------|
| [String Select](/docs/components/reference#string-select-string-select-interaction-response-structure) |
| [Text Input](/docs/components/reference#text-input-text-input-interaction-response-structure) |
| Component |
|-----------------------------------------------------------------------------------------------------------------------|
| [String Select](/docs/components/reference#string-select-string-select-interaction-response-structure) |
| [Text Input](/docs/components/reference#text-input-text-input-interaction-response-structure) |
| [User Select](/docs/components/reference#user-select-user-select-interaction-response-structure) |
| [Role Select](/docs/components/reference#role-select-role-select-interaction-response-structure) |
| [Mentionable Select](/docs/components/reference#mentionable-select-mentionable-select-interaction-response-structure) |
| [Channel Select](/docs/components/reference#channel-select-channel-select-interaction-response-structure) |
| [Text Display](/docs/components/reference#text-display-text-display-interaction-response-structure) |
| [Label](/docs/components/reference#label-label-interaction-response-structure) |

###### Resolved Data Structure

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/components/modal-role-select.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/components/modal-user-select.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.