2 min read
By Mike
Discord Components V2: The New Message Layout
Components V2 is a Discord message format that builds a message out of layout blocks such as containers, text, images, separators and buttons. It replaces the old pattern of an embed with a row of buttons underneath, and puts controls inside the card itself.
How it differs from embeds
In the classic format a bot sends message content, up to ten embeds and rows of buttons below them. The layout is fixed: the embed is one block and the buttons always hang underneath.
With Components V2 the bot sets a flag on the message and then describes it as a tree of blocks. You can put text, a thumbnail beside it, a media gallery, a separator line and a button all inside one container, and style the container with an accent color like an embed's side bar.
The main building blocks
- Container: the card that groups other blocks.
- Section: text with a button or thumbnail beside it.
- Text display: Markdown text, as many blocks as needed.
- Media gallery and file: pictures and downloads inside the card.
- Separator: spacing or a divider line.
- Action row: buttons and select menus, same as before.
Trade-offs to know
A message flagged as V2 cannot also use the old content and embed fields, so a bot picks one format per message. Older Discord clients that do not support V2 cannot show these messages properly, which is why many bots still offer both. V2 messages also cannot be turned back into classic ones, because the flag is set when the message is created.
The benefit is flexibility. Inline buttons, dropdowns that sit next to the text they control, and cleaner mobile layouts are all easier in V2.
How Noxyr handles it
Noxyr lets you choose V1 or V2 for each feature. V1 is the classic embed with buttons under it, and V2 puts buttons and dropdowns inside the message card. New servers start on V2. You can also turn ticket controls, poll votes or the music player into a single dropdown. Find it under Buttons and Menus in the dashboard, or use /style. The settings are described in the buttons and menus docs.
If you have a ticket panel, see how it looks in V2 in the ticket panels docs.
Should you switch?
If your members mostly use up to date Discord apps, V2 gives cleaner panels. If you want maximum compatibility, keep the classic look on important messages. The V2 versus classic embeds article has examples side by side.
Common questions
What is Components V2 on Discord?
A newer message format where bots build messages from layout blocks like containers, text, galleries and buttons instead of using embeds.
Can I use embeds and Components V2 in the same message?
No. A V2 message uses its own block layout and does not use the classic content and embed fields.
How do I switch Noxyr between V1 and V2?
Open Buttons and Menus in the dashboard or use /style to pick V1 or V2 per feature.
