From ae16b375d2ba2750986c674106d8b053185cf66c Mon Sep 17 00:00:00 2001
From: erikjohnston
system_mxid_display_name
: set the display name of the "notices" usersystem_mxid_avatar_url
: set the avatar for the "notices" userroom_name
: set the room name of the server notices roomroom_avatar_url
: optional string. The room avatar to use for server notice rooms. If set to the empty string ""
, notice rooms will not be given an avatar. Defaults to the empty string. Added in Synapse 1.99.0.room_topic
: optional string. The topic to use for server notice rooms. If set to the empty string ""
, notice rooms will not be given a topic. Defaults to the empty string. Added in Synapse 1.99.0.auto_join
: boolean. If true, the user will be automatically joined to the room instead of being invited.
Defaults to false. Added in Synapse 1.98.0.Note that the name, topic and avatar of existing server notice rooms will only be updated when a new notice event is sent.
Example configuration:
server_notices:
system_mxid_localpart: notices
system_mxid_display_name: "Server Notices"
- system_mxid_avatar_url: "mxc://server.com/oumMVlgDnLYFaPVkExemNVVZ"
+ system_mxid_avatar_url: "mxc://example.com/oumMVlgDnLYFaPVkExemNVVZ"
room_name: "Server Notices"
+ room_avatar_url: "mxc://example.com/oumMVlgDnLYFaPVkExemNVVZ"
+ room_topic: "Room used by your server admin to notice you of important information"
auto_join: true
server_notices:
system_mxid_localpart: server
system_mxid_display_name: "Server Notices"
- system_mxid_avatar_url: "mxc://server.com/oumMVlgDnLYFaPVkExemNVVZ"
+ system_mxid_avatar_url: "mxc://example.com/oumMVlgDnLYFaPVkExemNVVZ"
room_name: "Server Notices"
+ room_avatar_url: "mxc://example.com/oumMVlgDnLYFaPVkExemNVVZ"
+ room_topic: "Room used by your server admin to notice you of important information"
auto_join: true
The only compulsory setting is system_mxid_localpart
, which defines the user
id of the Server Notices user, as above. room_name
defines the name of the
-room which will be created.
room_avatar_url
its avatar and room_topic
its topic.
system_mxid_display_name
and system_mxid_avatar_url
can be used to set the
displayname and avatar of the Server Notices user.
auto_join
will autojoin users to the notices room instead of sending an invite.