What is Components V2 on Discord?

It is the newer way to build a message entirely out of components: text displays, sections, media galleries, separators and containers, alongside buttons and select menus. A message using it cannot also have content or embeds.

How many buttons can a Discord message have?

A classic message holds up to five action rows, and a row holds up to five buttons, so 25 buttons. A select menu takes a whole row to itself.

Do buttons work without a bot?

Link buttons open a web address and need nothing behind them. Every other button and every select menu sends an interaction that an application has to answer.

All tools

Discord components generator

Build classic buttons and selects or Components V2 layouts, then export JSON.

Build your message

Message format

Use text displays, images, separators and interactive rows. Your export includes the required V2 flag.

Group in a container

1. text

Text display

2. separator

Show divider

Large spacing

3. buttons

Button 1 label

Button style

Button custom ID

Disabled button

Live preview

Approximate appearance · 5 components including nested items

Welcome aboard

Choose a topic to get started.

Message JSON

Ready to export. Mentions are disabled by default.

{
  "flags": 32768,
  "components": [
    {
      "type": 17,
      "accent_color": 5793266,
      "components": [
        {
          "type": 10,
          "content": "# Welcome aboard\nChoose a topic to get started."
        },
        {
          "type": 14,
          "divider": true,
          "spacing": 1
        },
        {
          "type": 1,
          "components": [
            {
              "type": 2,
              "label": "Get started",
              "style": 1,
              "disabled": false,
              "custom_id": "get_started"
            }
          ]
        }
      ]
    }
  ],
  "allowed_mentions": {
    "parse": []
  }
}

Using your Discord components

Export the message body for your bot’s message API. Buttons with custom IDs and select menus need an interaction handler in your bot. V2 replaces ordinary content and embeds with display components. For webhooks, add with_components=true to the request URL; ordinary incoming webhooks support non-interactive components, such as link buttons. Use an application-owned webhook or bot for interactive buttons and selects. Image previews load directly in your browser.

Discord component reference

How to use the Discord components generator

Choose classic components (buttons and select menus in action rows) or a Components V2 layout with text, images, sections and containers.
Add and arrange the pieces. The preview shows the message the way Discord draws it.
Copy or download the JSON and send it from your bot. A Components V2 message needs the IS_COMPONENTS_V2 message flag set.

Common questions

What is Components V2 on Discord?: It is the newer way to build a message entirely out of components: text displays, sections, media galleries, separators and containers, alongside buttons and select menus. A message using it cannot also have content or embeds.
How many buttons can a Discord message have?: A classic message holds up to five action rows, and a row holds up to five buttons, so 25 buttons. A select menu takes a whole row to itself.
Do buttons work without a bot?: Link buttons open a web address and need nothing behind them. Every other button and every select menu sends an interaction that an application has to answer.

Build a community people come back to

Practical guides for finding your people and growing a welcoming server.

All community guides

Field guide
Community field notes
1 min read · Community guide
Seven honest ways to grow a Discord server
Grow your Discord server with practical onboarding, moderation and event ideas. Improve community activity and retention before spending more on promotion.
Field guide
Community field notes
3 min read · Community guide
Discord Leveling Systems: XP and Rewards
Build a Discord leveling system with fair XP cooldowns, sensible role rewards and voice rules. Use a worked level curve and checks that discourage spam farming.