Skip to content

Commit c111d25

Browse files
authored
Document sending 0 IDs in 'Anatomy of a Component'
Also Reworded legacy section
1 parent 05abf7d commit c111d25

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/components/reference.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ All components have the following fields:
6464
| type | integer | The [type](/docs/components/reference#component-object-component-types) of the component |
6565
| id? | integer | 32 bit integer used as an optional identifier for component |
6666

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.
6868

6969
###### Custom ID
7070

@@ -1172,7 +1172,7 @@ To upload a file with your message, you'll need to send your payload as `multipa
11721172

11731173
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`.
11741174

1175-
Messages preceding components V2 will contain an `id` of `0`, sending back `0` is allowed but will be incremented to 1, then generated sequentially while avoiding duplicates.
1175+
Additionally, components of messages preceding components V2 will contain an `id` of `0`.
11761176

11771177
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.
11781178

0 commit comments

Comments
 (0)