22type : module
33---
44
5- ### User, room, and group mentions
5+ ### User and room mentions
66
7- This module allows users to mention other users, rooms, and groups
8- within a room message. This is achieved by including a [ matrix.to
9- URI] ( /appendices/#matrixto-navigation ) in the HTML body of an
10- [ m.room.message] ( #mroommessage ) event. This module does not have any server-specific
7+ This module allows users to mention other users and rooms within a room message.
8+ This is achieved by including a [ Matrix URI] ( /appendices/#uris ) in the HTML body of
9+ an [ m.room.message] ( #mroommessage ) event. This module does not have any server-specific
1110behaviour to it.
1211
1312Mentions apply only to [ m.room.message] ( #mroommessage ) events where the ` msgtype ` is
@@ -28,7 +27,7 @@ To make a mention, reference the entity being mentioned in the
2827
2928#### Client behaviour
3029
31- In addition to using the appropriate ` matrix.to URI` for the mention,
30+ In addition to using the appropriate ` Matrix URI` for the mention,
3231clients should use the following guidelines when making mentions in
3332events to be sent:
3433
@@ -40,7 +39,6 @@ events to be sent:
4039 listed on the room. If no alias can be found, fall back to the room
4140 ID. In all cases, use the alias/room ID being linked to as the
4241 anchor's text.
43- - When referencing groups, use the group ID as the anchor's text.
4442
4543The text component of the anchor should be used in the event's ` body `
4644where the mention would normally be represented, as shown in the example
@@ -56,4 +54,11 @@ mention differently from other mentions, such as by using a red
5654background color to signify to the user that they were mentioned.
5755
5856When clicked, the mention should navigate the user to the appropriate
59- room, group, or user information.
57+ user or room information.
58+
59+ {{% boxes/note %}}
60+ Similar to legacy [ matrix.to URLs] ( /appendices/#matrixto-navigation ) ,
61+ groups used to be representable by mentions. They follow a similar format
62+ to room mentions, though using the group ID in both the link and anchor
63+ text.
64+ {{% /boxes/note %}}
0 commit comments