Skip to content
This repository was archived by the owner on Oct 5, 2025. It is now read-only.

Commit 4197a8c

Browse files
committed
chore: improvements from review
* don't mention update where it isn't applicable * use correct field name for poll * editing requires not supported fields to be set to null * mention that attached files need to be referenced
1 parent 8ce8c58 commit 4197a8c

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

guide/popular-topics/display-components.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,22 @@
22

33
While you might be familiar with [embeds](/popular-topics/embeds.md) in Discord, there are more ways to style and format your apps messages using **display components**, a comprehensive set of layout and content elements.
44

5-
To use the display components, you need to pass the `IsComponentsV2` message flag (<DocsLink path="MessageFlags:Enum" />) when sending a message. You only need to use this flag when sending a message using the display components system, not when deffering interaction responses or updates.
5+
To use the display components, you need to pass the `IsComponentsV2` message flag (<DocsLink path="MessageFlags:Enum" />) when sending a message. You only need to use this flag when sending a message using the display components system, not when deffering interaction responses.
66

77
::: warning
88
Opting into using this system by passing the `IsComponentsV2` comes with a set of caveats:
9-
- You **cannot** send `content`, `polls`, `embeds`, or `stickers`.
9+
- You **cannot** send `content`, `poll`, `embeds`, or `stickers`.
1010
- You **cannot** opt out of using display components when editing a message
11-
- You **can** opt into using display components when editing a message
11+
- You **can** opt into using display components when editing a message while explicitly setting `content`, `poll`, `embeds`, and `stickers` to null.
1212
- Messages can have up to **40** total components (nested components count!)
1313
- The amount of text across all text display components **cannot** exceed 4000 characters.
14+
- All attached files have to explicitly be referenced in a component (refer to the [Thumbnail](/popular-topics/display-components#thumbnail), [Media Gallery](/popular-topics/display-components#media-gallery), and [File](/popular-topics/display-components#file) sections).
1415
:::
1516

17+
1618
All components can be passed an optional `id` field holding a 32-bit integer identifier to later identify them in interaction responses. Do not confuse this with the `custom_id` field for interactive components! You can find more information about this field [on the discord API documentation](https://discord.com/developers/docs/components/reference#anatomy-of-a-component).
1719

20+
1821
In the following section, we will explain all display components in detail, how they work together with interactive components, and their limitations.
1922

2023
## Text Display

0 commit comments

Comments
 (0)