You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/components/reference.mdx
+5-3Lines changed: 5 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -64,7 +64,7 @@ All components have the following fields:
64
64
| type | integer | The [type](/docs/components/reference#component-object-component-types) of the component |
65
65
| id? | integer | 32 bit integer used as an optional identifier for component |
66
66
67
-
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 `id`s won't use another `id` that exists in the message if you have one defined for another component.
67
+
The `id` field is optional and is used to identify components in the response from an interaction. The `id` must be unique within the message and is generated sequentially if left empty. Generation of `id`s won't use another `id` that exists in the message if you have one defined for another component. Sending components with an `id` of `0` is allowed but will be treated as empty and replaced by the API.
68
68
69
69
###### Custom ID
70
70
@@ -949,7 +949,7 @@ To use this component, you need to send the [message flag](/docs/resources/messa
949
949
| type | integer |`11` for thumbnail component |
950
950
| id? | integer | Optional identifier for component |
951
951
| media |[unfurled media item](/docs/components/reference#unfurled-media-item-structure)| A url or attachment |
952
-
| description? | string | Alt text for the media|
952
+
| description? | string | Alt text for the media, max 1024 characters|
953
953
| spoiler? | boolean | Whether the thumbnail should be a spoiler (or blurred out). Defaults to `false`|
954
954
955
955
###### Example
@@ -979,7 +979,7 @@ To use this component, you need to send the [message flag](/docs/resources/messa
| media |[unfurled media item](/docs/components/reference#unfurled-media-item-structure)| A url or attachment |
982
-
| description? | string | Alt text for the media|
982
+
| description? | string | Alt text for the media, max 1024 characters|
983
983
| spoiler? | boolean | Whether the media should be a spoiler (or blurred out). Defaults to `false`|
984
984
985
985
###### Example
@@ -1209,6 +1209,8 @@ To upload a file with your message, you'll need to send your payload as `multipa
1209
1209
1210
1210
Before the introduction of the `IS_COMPONENTS_V2` flag ([see changelog](/docs/change-log/2025-04-22-components-v2)), message components were sent in conjunction with message content. This means that you could send a message using a subset of the available components without setting the `IS_COMPONENTS_V2` flag, and the components would be included in the message content along with `content` and `embeds`.
1211
1211
1212
+
Additionally, components of messages preceding components V2 will contain an `id` of `0`.
1213
+
1212
1214
Apps using this Legacy Message Component behavior will continue to work as expected, but it is recommended to use the new `IS_COMPONENTS_V2` flag for new apps or features as they offer more options for layout and customization.
0 commit comments