Raise the roof

Author: anthonydiscord

docs/change-log/2025-04-29-component-limits.md

@@ -0,0 +1,20 @@
+---
+title: "Raised Component Limits"
+date: "2025-04-29"
+topics:
+- "User Apps"
+- "HTTP API"
+- "Interactions"
+---
+
+We're removing the top level component limit and raising the limit on components in messages to 40 when using the [`IS_COMPONENTS_V2` message flag](/docs/resources/message#message-object-message-flags)! Legacy messages have not changed and continue to allow up to 5 action rows.
+
+#### What's New
+
+- **Total components**: The limit for total components in a message has been increased to 40.
+- **Top-level components**: There is no longer a limit on top level components in a message (previously it was 10).
+
+#### Developer Resources
+
+- Check out our [Component Reference](/docs/components/reference) for detailed specifications on all available components.
+- Learn how to build rich message layouts with components with [Using Message Components](/docs/components/using-message-components).

docs/components/reference.mdx

@@ -15,7 +15,7 @@ To use these components, you need to send the [message flag](/docs/resources/mes
 - The `content` and `embeds` fields will no longer work but you'll be able to use [Text Display](/docs/components/reference#text-display) and [Container](/docs/components/reference#container) as replacements
 - Attachments won't show by default - they must be exposed through components
 - The `poll` and `stickers` fields are disabled
-- Messages currently allow up to 10 top-level components and 30 total components
+- Messages allow up to 40 total components
 
 :::info
 [Legacy component behavior](/docs/components/reference#legacy-message-component-behavior) will continue to work but provide less flexibility and control over the message layout.
@@ -1172,6 +1172,10 @@ Before the introduction of the `IS_COMPONENTS_V2` flag ([see changelog](/docs/ch
 
 Apps using this Legacy Message Component behavior will continue to work as expected, but it is recommended to use the new `IS_COMPONENTS_V2` flag for new apps or features as they offer more options for layout and customization.
 
+:::info
+Legacy messages allow up to 5 action rows as top-level components
+:::
+
 Legacy Message Component Example
 
 ```json