Components

#Overview

Components V2 (or cv2) is an alternative to embeds for building rich, interactive messages. Unlike embeds which are mostly display-only, Components V2 lets you build messages with interactive elements like buttons, dropdowns, galleries, and card-like containers. Use Components V2 when you want a modern, interactive layout; use embeds for text-heavy information displays.

Components V2 messages cannot contain both embeds and components in the same message—it's one or the other.

#Getting Started

{cv2}
{text: Your message text}
{button: Click me && url: https://example.com}
{section: {text: Title}{thumbnail: https://example.com/image.png}}
{container: accent: #5d86cf && {text: Colored card}}
{gallery: https://example.com/1.png && https://example.com/2.png}

#Components

#Text

A plain text block. Variables like {user.mention} and {guild.name} are substituted normally.

{cv2}{text: Hello {user.mention}, welcome to {guild.name}!}

#Section

A card containing up to 3 lines of text and one accessory (either a thumbnail image or a button). Sections are useful for highlighting featured content.

Structure:

{section: {text: Line 1}{text: Line 2}{text: Line 3}{thumbnail: url}}

or with a button instead:

{section: {text: Line 1}{button: Click here && url: https://...}}

Example:

{cv2}{section: {text: Featured Server}{text: Join 10k+ members}{text: Click the button to apply}{button: Join Now && url: https://discord.gg/greed}}

#Button

A clickable button. Can be a link button (opens a URL) or a custom button (triggers a bot action).

Link buttons:

{button: Label && url: https://example.com}

Custom buttons:

{button: Label && custom_id: my_script && style: primary}

Full options (separated by &&):

• label: text — Button text
• url: https://... — Link target (creates a link button; always renders as Link style, ignoring any style: parameter)
• custom_id: name or custom: name or id: name — Custom script name (creates a custom button that triggers the script)
• style: primary|secondary|success|danger — Color style (ignored for link buttons)
• disabled — Disables the button

Styles (and aliases):

• primary or blurple
• secondary or grey or gray
• success or green
• danger or red

Positional shorthand:

• A non-URL part becomes the label
• An http:// or https:// URL becomes the link

{cv2}{button: Documentation && https://greed.best}{button: Verify && custom_id: verify && style: success}

Custom button scripts: The custom: name must refer to a custom script saved in the same server with ,custom add. The name must start with a lowercase letter or digit, be 1–32 characters total, and contain only lowercase letters, digits, underscores, or hyphens. If the label is omitted, the script's name is used as the label.

Clicking the button renders the saved script and sends it as an ephemeral reply — only the person who clicked sees it. The script is rendered against the clicker, so {user.*} refers to them and {guild.*} / {channel.*} refer to where they clicked. Every click also increments the script's use counter, visible in ,custom list.

,custom add rules {embed}$v{title: Server Rules}$v{description: Be kind. No spam.}

{cv2}{text: Read before posting}{button: label: Server Rules && custom: rules && style: primary}

#Button & Action Rows

By default, buttons appear in action rows automatically. To control button layout or combine buttons with dropdowns, use {actionrow}:

{cv2}
{actionrow: {button: First}{button: Second}{button: Third}}
{actionrow: {select: placeholder: Choose an option && Label 1: value1 && Label 2: value2}}

#Select / Dropdown

A dropdown menu for display only. This component is always disabled and cannot be interacted with—it is purely decorative. Use it to show available options or configuration possibilities to users who cannot yet interact with them.

Syntax:

{select: placeholder: Choose one && Label: value && Label: value}

Example:

{cv2}{select: placeholder: Pick a role && Member: member && Moderator: mod && Admin: admin}

Options:

• placeholder: text — Sets the displayed placeholder text
• Each option is Label: value separated by &&. A bare word with no colon becomes both label and value.
• Up to 25 options per dropdown (extras are ignored)
• disabled, min_values:, and max_values: are parsed but have no effect (the dropdown is always disabled)

#Separator

A horizontal divider line. Use for visual separation between sections.

{cv2}{text: Section 1}{separator:}{text: Section 2}

Options:

• large or spacing: 2 — Adds extra spacing above the separator
• divider: false — Removes the visible line (just adds spacing)

{cv2}{text: Top}{separator: large}{text: Bottom}

#Gallery / Media

Display multiple images in a gallery layout. Images are separated by &&.

Syntax:

{gallery: url1 && url2 && url3}

Per-image options:

• description: text — Caption for the previous image
• spoiler — Marks the previous image as spoiler

Example:

{cv2}{gallery: https://example.com/photo1.png && description: First photo && https://example.com/photo2.png && spoiler && description: Hidden photo}

#Container

A colored card that groups content together. All content inside inherits the accent color styling.

Syntax:

{container: accent: #hex && {text: ...}{button: ...}{section: ...}}

Accent color options:

• accent: #5d86cf or accent_color: #5d86cf or accent_colour: #5d86cf

Inside a container, you can nest:

• {text: ...}
• {button: ...}
• {section: ...}
• {separator: ...}
• {gallery: ...}
• {actionrow: ...}
• {select: ...}

Example:

{cv2}{container: accent: #5d86cf && {text: Official Announcement}{text: Read the details below}{separator:}{text: We've launched a new feature! Check it out.}{button: Learn More && url: https://greed.best}}

#Variables & Substitution

All standard greed variables resolve inside Components V2 templates, just as they do in embeds. Refer to the Variables page for the complete list.

{cv2}{text: Hello {user.mention}!}{text: Server: {guild.name}}{button: Your Profile && url: https://example.com}

#URL Validation

URLs must be valid HTTP/HTTPS links or use the attachment:// scheme:

• https://example.com/image.png ✓
• http://example.com/file.png ✓
• attachment://filename ✓ (must be longer than 13 characters)
• example.com/image.png ✗ (missing protocol)
• ftp://example.com ✗ (protocol not supported)

Invalid URLs are silently dropped from the message.

#Limits & Constraints

#Troubleshooting