add caveat for allowed mentions in interactions

AlmostSuspense · web-flow · commit 2f1ad9f8312d · 2025-06-22T15:23:38.000+02:00
diff --git a/docs/resources/message.mdx b/docs/resources/message.mdx
@@ -650,9 +650,9 @@ The allowed mention field allows for more granular control over mentions without
 
 Due to the complexity of possibilities, we have included a set of examples and behavior for the allowed mentions field.
 
-If `allowed_mentions` is _not_ passed in (i.e. the key does not exist), the mentions will be parsed via the message content or message component content. This corresponds with existing behavior.
+If the `allowed_mentions` field is not passed in the body, mentions will be parsed based on the content of the message and its components, except in interactions, where only user mentions are parsed by default. You will need to configure `allowed_mentions` in order to ping `@everyone`, `@here` or roles.
 
-In the example below we would ping @here (and also @role124 and @user123)
+In the example below, we would ping @here (and also @role124 and @user123):
 
 ```json
 {

Original file line number	Diff line number	Diff line change
`@@ -650,9 +650,9 @@ The allowed mention field allows for more granular control over mentions without`
`650`	`650`
`651`	`651`	`Due to the complexity of possibilities, we have included a set of examples and behavior for the allowed mentions field.`
`652`	`652`
`653`		-If `allowed_mentions` is _not_ passed in (i.e. the key does not exist), the mentions will be parsed via the message content or message component content. This corresponds with existing behavior.
	`653`	+If the `allowed_mentions` field is not passed in the body, mentions will be parsed based on the content of the message and its components, except in interactions, where only user mentions are parsed by default. You will need to configure `allowed_mentions` in order to ping `@everyone`, `@here` or roles.
`654`	`654`
`655`		`-In the example below we would ping @here (and also @role124 and @user123)`
	`655`	`+In the example below, we would ping @here (and also @role124 and @user123):`
`656`	`656`
`657`	`657`	```json
`658`	`658`	`{`