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 itemWhat it holds
ContainerA framed box with an optional accent colour and spoiler, holding the blocks below
TextMarkdown text, including headings and lists
SectionUp to 3 text lines plus one accessory: a thumbnail or a link button
Image gallery1 to 10 images laid out as a grid
SeparatorA gap with or without a divider line, in normal or large spacing
FileAn attached file members can download
ButtonAn 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

  1. Open the RestoreCord embed builder and click the Components V2 tab above the canvas.
  2. Drag a Container in and pick an accent colour. Everything else will live inside it.
  3. Add a Text block for the headline, then a Separator to give it breathing room.
  4. Drop in a Section for each point that deserves a thumbnail or a single button beside it.
  5. 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

  1. Switch the canvas to Components V2

    Open the RestoreCord embed builder and pick the Components V2 tab above the canvas.

  2. Drop in a container

    Drag a Container from the palette and give it an accent colour so the layout has a frame.

  3. Fill it with blocks

    Add text, sections with a thumbnail or button, a gallery, separators and files in reading order.

  4. Send through your webhook

    Press Send, paste the webhook URL and the layout posts with the Components V2 flag set for you.

Open the Components V2 canvas

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.