diff --git a/content/client-server-api/modules/mentions.md b/content/client-server-api/modules/mentions.md
index 972e19f5..6ea55f22 100644
--- a/content/client-server-api/modules/mentions.md
+++ b/content/client-server-api/modules/mentions.md
@@ -10,7 +10,7 @@ This is achieved by including metadata in the `m.mentions` content property of
 the event. The `m.mentions` property consists of an object with two fields:
 
 * `user_ids`: A list of Matrix IDs of mentioned users.
-* `room`: A boolean set to `true` to mention the room. (`room` should otherwise
+* `room`: A boolean set to `true` to mention the room, for an `@room` notification. (`room` should otherwise
   not be included on the event.)
 
 Although it is possible to silently mention users, it is recommended to include a