Containers & components

Embeds are fine, but they’re rigid. Containers are Discord’s newer layout system: a bordered block with a coloured accent bar that you fill with headers, text, images, thumbnails and buttons in whatever order you like. Anywhere you can write an embed script, you can write a container instead.

{box: #5cacec}
{box.header: Server Rules}
{box.text: Be decent to each other. That's mostly it.}
{box.separator}
{box.text: Breaking them gets you a warn, then a mute, then a ban.}
{box.button: label: "Full rules" url: "https://example.com" style: "link"}

Opening a container

Node	Aliases	Notes
`{container}`	`box`, `cntr`, `ctr`	Opens a container
`{container: #hex}`	—	Opens one with an accent colour
`{container: dominant}`	—	Accent taken from the first image inside

Everything after it that starts with container. (or box., etc.) belongs to that container. Open a second {box} to start a new one.

What goes inside

Text and headers

Node	Aliases
`{box.header: ...}`	`heading`, `h`, `title`
`{box.text: ...}`	`description`, `desc`, `txt`, `body`

{box.header: Welcome to {guild.name}}
{box.text: {user.mention}, you're member **{guild.members}**.}

Both support full Discord markdown, including -# subtext and > quotes.

Separators

{box.separator}
{box.separator: large}

Aliases: sep, divider, hr. Pass large (or lg / big) for more breathing room; anything else gives the small spacing.

Images and galleries

{box.image: https://example.com/one.png}
{box.image: https://example.com/one.png | https://example.com/two.png}

Aliases: img, gallery, media, photo, pic. Multiple URLs separated by | become a media gallery — Discord lays them out as a grid.

Sections and thumbnails

A section is text with a thumbnail floated beside it.

{box.section: text: "Level 12 — 4,200 xp" thumbnail: "{user.avatar}"}

Aliases: sec, row. The text part accepts text, label, description, desc, content or body; the image part accepts thumbnail, thumb, image, img or icon.{box.thumbnail: <url>} is the shorthand for a thumbnail with no text next to it.

Buttons

Identical to top-level buttons, just scoped inside the container:

{box.button: label: "Get roles" emoji: "🎭" style: "success" message: "Head to #roles"}

Accent colour

Set on the opening node, or separately afterwards:

{box}
{box.color: #ff5c8a}

{box.dominant}

{box.dominant} pulls the colour from the first Discord-hosted image in the container.

Container vs embed

Neither is better — they’re for different shapes of message.

	Embed	Container
Layout	Fixed: title, description, fields, image	Free — items in the order you write them
Images	One large, one thumbnail	Any number, including galleries
Buttons	Below the embed	Anywhere inside
Accent	Left colour bar	Left colour bar
Best for	Structured info, field grids	Announcements, panels, anything with mixed media

You can use both in one message — a container plus an embed plus plain content all render together.

A worked example

A welcome message that actually looks designed:

!welcome add #general {content: {user.mention}}
{box: dominant}
{box.section: text: "## Welcome to {guild.name}
{user.name} — you're our **{guild.members|comma}th** member." thumbnail: "{user.avatar}"}
{box.separator}
{box.text: -# account created <t:{user.created_at}:R>}
{box.button: label: "Read the rules" style: "secondary" message: "Head over to #rules — it takes 30 seconds."}

Build it with !embed first so you can see it, tweak it, and only paste it into !welcome add once you’re happy. !copyembed on the result gives you the script back if you lose it.

Limits

Discord enforces these, not the bot:

40 components total per message
10 buttons, across a maximum of 5 rows
4000 characters across all text in the message
Media gallery items must be reachable image URLs

Going over any of these means the message won’t send. If a script silently fails to appear, this is usually why — trim it down and try again.

​Opening a container

​What goes inside

​Container vs embed

​A worked example

​Limits

Opening a container

What goes inside

Container vs embed

A worked example

Limits