| Status | Last updated |
|---|---|
| In Progress | April 12, 2023 |
New Users should have default notification settings that make sense. They should be easy to grok, and easy to change.
Notification documentation is currently in progress. Track along here (Internal only)
The Global Settings screen for Notifications has been redesigned. The issue regarding these changes can be found here.
| Web Setting | Default/ Enabled | What does it mean | Push rules (see predefined rules |
|---|---|---|---|
| Enable Notifications for this account | Disabled (when enabled, push notifications are off) | Setting previously existed. No change. https://spec.matrix.org/v1.6/client-server-api/#default-override-rules | .m.rule.master |
| Enable desktop notifications | Off | We have to ask permission before turning this on. The setting previously existed, there's no change. | N/A |
| Show message preview in desktop notification | Off | Setting previously existed. No change. | N/A |
| Enable audible notifications | On | Setting previously existed. No change. | N/A |
| Default settings for all rooms | All messages | All messages in all rooms are set to "On" by default. There's more information on this decision here. | .m.rule.encrypted_room_one_to_one, .m.rule.room_one_to_one, .m.rule.message, .m.rule.encrypted |
| Play a sound for | All messages | This is the equivalent of "Noisy". | Customise actions of .m.rule.encrypted_room_one_to_one, .m.rule.room_one_to_one, .m.rule.message, .m.rule.encrypted |
| Invited to a room | On | Setting previously existed. Its default is “On” and the “Noisy” aspect is determined by the user's Sound settings. | .m.rule.invite_for_me |
| New room activity, upgrades, and status messages | Off | This is a catch-all bucket. Better explanation pending discussion. | .m.rule.tombstone + new ones |
| Messages sent by a bot | On | Setting previously existed. No change. | .m.rule.suppress_notices |
| Mentions when someone uses "@room" | On | Setting previously existed. Its default is “On” and the “Noisy” aspect is determined by the user's Sound settings. | .m.rule.roomnotif (MCS3952 defines .m.rule.is_room_mention) |
| Mentions when someone uses "@displayname" | On | Setting previously existed. Its default is “On” and the “Noisy” aspect is determined by the user's Sound settings. | .m.rule.contains_display_name and .m.rule.constains_user_name (maybe?) (MCS3952 defines .m.rule.is_user_mention) |
| Notify when someone users a keyword | On | There are no preset keywords configured. Setting previously existed. No change. | A custom rule is created for each keyword |
| Email summary | Off | Setting previously existed. We should improve our emails before subjecting all users to them. | N/A |
| This line is blank intentionally | N/A | N/A | N/A |
The Element X team is currently working on which settings they will show to users. The above list has been collaboratively designed by both the Web and Element X Mobile teams and therefore we will have platform parity at launch. When Element X Notifications Settings screens have been designed and built, this document should be updated and a new table added to the above section.
While this work is still being built, we'll include the design here for reference:
| WIP |
|---|
 |