Components V2
A template with components like sections, galleries, and containers.
Components V2 templates replace the traditional text + embed layout with a stack of display components — the same building blocks Discord uses for modern, structured messages. They live in the library and work everywhere traditional templates do: commands, ticket panels, and chained template actions.
For plain text, embeds, and classic action rows, see Traditional Template.
Display components
A V2 template is an ordered list of components. You can mix and nest them to build rich layouts.
| Component | Purpose |
|---|---|
| Text | A block of markdown text. |
| Section | Up to three text blocks beside a thumbnail or button accessory. |
| Media gallery | A grid of up to ten images or media items. |
| File | Attach and display a file (including attachment:// references). |
| Separator | A visual divider with small or large spacing. |
| Container | Groups child components with an optional accent color and spoiler tag. |
| Action row | A row of buttons or a select menu, same as traditional templates. |
Sections pair body text with a thumbnail (image with optional alt text) or a single button on the side. Containers can hold any other component type, including nested containers, so you can group related content with a colored border.
Interactive components
Buttons and select menus work the same as on traditional templates. Wire them to actions — for example, a section accessory button that creates a ticket, or an action row at the bottom of a container that follows up with another template.
Variables
All the same variables work in Components V2 — in text blocks, media URLs, button labels, and more.
Media URLs also accept attachment:// references for files uploaded with the
message, in addition to regular URLs and ${...} variables like
${guild.icon}.
Limits
Discord enforces a component budget on V2 messages. Assistance validates these in the editor so you know before you save.
| Limit | Value |
|---|---|
| Total components | 40 (includes nested children, section accessories, and row elements) |
| Total text | 4,000 characters across all text blocks |
| Text per block | 4,000 characters |
| Section text blocks | Up to 3 |
| Gallery items | Up to 10 |
When to use Components V2
Reach for V2 when you want structured layouts — side-by-side text and images, grouped content in colored containers, media galleries, or separators between sections — without stacking multiple embeds.
Traditional templates are still a good fit for simple announcements, embed-heavy messages, or content you already have in embed form.
Creating V2 templates
From the library, choose Components V2 when creating a new template, or pick a V2 example to start from.
How is this guide?