Discord adds Components V2 for message layouts
What changed
On April 22, 2025 Discord introduced Components V2: Section, Container, Separator, Text Display, Thumbnail, Media Gallery and File components, enabled per message with the IS_COMPONENTS_V2 flag (1 << 15). With the flag, content and embeds no longer work, attachments must be exposed through components, and poll and stickers are disabled. On April 29, 2025 Discord raised the limit to 40 total components, removed the top-level limit (previously 10) and the Container limit. Legacy messages still allow up to 5 action rows.
What it means
Bots and apps can build messages from text, image galleries, files and containers in any order, but such messages cannot use the normal content, embeds or poll fields.
Who is affected
Bots and integrations that post formatted announcements to Discord channels.
What to do by 22 Apr 2025
Optional. Set the IS_COMPONENTS_V2 flag (1 << 15) and send Text Display, Media Gallery, File and Container components; attachments must be shown through components.
What this means for you
Discord added a new way for apps to lay out a post: blocks of text, picture grids, files and boxes, placed in any order. Posts can look more like a small web page. It is optional, and old-style posts keep working exactly as before.
The details
- Opt-in: message flag
IS_COMPONENTS_V2(1 << 15), per message. - Layout components: Section, Container (with accent color), Separator.
- Content components: Text Display (markdown text), Thumbnail, Media Gallery, File.
- Trade-offs with the flag:
contentandembeds"will no longer work"; attachments must be exposed through a Media Gallery, Thumbnail or File component to be visible;pollandstickersare disabled. - Limits: launched at 10 top-level and 30 total components; since April 29, 2025, 40 total components, no top-level limit and no limit inside a Container.
- Legacy: messages without the flag behave as before, with up to 5 action rows.
What to do next
- Business owners: Nothing.
- Marketers and agencies: Richer Discord announcement layouts are possible if your tool supports them; polls still need a normal message.
- Developers: If you adopt the flag, move text from
contentandembedsinto Text Display and Container, reference every upload from a component, and stay within 40 components.
Primary sources
- Discord Developer change log: Introducing New Components for Messages (April 22, 2025)
- Discord Developer change log: Raised Component Limits (April 29, 2025)
- Discord Developer docs: Component reference
Get an email when a new API change is added
Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.