Discord Components V2: build container messages without code
Components V2 lets a message become a small page: framed containers, text beside a thumbnail, image galleries and files. Here is how the pieces fit and how to build one visually.
Short answer
Components V2 is Discord's layout system where a message is built from components instead of content plus embeds. Wrap blocks in an accent-coloured container, add text, sections, galleries, separators, files and link buttons, and send it through a webhook. RestoreCord's free builder does all of this on a canvas.
Why bother with a second message format
A classic embed is one card with a fixed shape: title on top, description, fields, one big image, footer. That works for most announcements, but it fights you when the post needs two images next to each other, a thumbnail beside a specific paragraph, or a downloadable file inside the design. Components V2 removes the fixed shape. You stack the blocks you need, in the order you want, and Discord renders them as one tidy message.
The building blocks
The builder's palette gives you these blocks:
| Palette item | What it holds |
|---|---|
| Container | A framed box with an optional accent colour and spoiler, holding the blocks below |
| Text | Markdown text, including headings and lists |
| Section | Up to 3 text lines plus one accessory: a thumbnail or a link button |
| Image gallery | 1 to 10 images laid out as a grid |
| Separator | A gap with or without a divider line, in normal or large spacing |
| File | An attached file members can download |
| Button | An action row of up to 5 link buttons |
The budget you are working with
Components V2 swaps the embed character rules for its own. A message can hold 40 components in total, and every container, text block, separator and button counts toward that number. All the text across those components is capped at 4,000 characters. If you are coming from embeds, the classic numbers live in the embed limits cheat sheet.
Separators are the cheapest thing to cut. If the counter says you are over 40 components, remove decorative dividers first and keep the content.
Building one on the canvas
- Open the RestoreCord embed builder and click the Components V2 tab above the canvas.
- Drag a Container in and pick an accent colour. Everything else will live inside it.
- Add a Text block for the headline, then a Separator to give it breathing room.
- Drop in a Section for each point that deserves a thumbnail or a single button beside it.
- Finish with a gallery or file if the post needs them, and a row of link buttons.
The preview updates as you place each block, so you see spacing and image crops before anything reaches Discord.
Images you pick from your device are attached to the same send, so you never upload them to a host first. The guide to embed images explains how that works and where it stops.
A note on buttons
Webhooks can only carry link buttons, so every button in a Components V2 design needs a full https:// address. Buttons that verify members or run actions need a bot. That is the job of the Message Studio in a free RestoreCord account, which designs messages for your own custom bot.
New to webhooks? Start with getting a webhook URL safely, or go back to the RestoreCord Embeds home page to compare both modes.
Your first container layout in four moves
Switch the canvas to Components V2
Open the RestoreCord embed builder and pick the Components V2 tab above the canvas.
Drop in a container
Drag a Container from the palette and give it an accent colour so the layout has a frame.
Fill it with blocks
Add text, sections with a thumbnail or button, a gallery, separators and files in reading order.
Send through your webhook
Press Send, paste the webhook URL and the layout posts with the Components V2 flag set for you.
Components V2 questions
Lay out a message, not just a card
Containers, sections and galleries, previewed as you drop them and sent through your own webhook.