diff --git a/changelogs/client_server/newsfragments/1320.clarification b/changelogs/client_server/newsfragments/1320.clarification new file mode 100644 index 00000000..5126d590 --- /dev/null +++ b/changelogs/client_server/newsfragments/1320.clarification @@ -0,0 +1 @@ +Clarify that `.m.rule.master` has a higher priority than any push rule. diff --git a/content/client-server-api/modules/push.md b/content/client-server-api/modules/push.md index 554b5752..be09921b 100644 --- a/content/client-server-api/modules/push.md +++ b/content/client-server-api/modules/push.md @@ -365,18 +365,21 @@ Parameters: ##### Predefined Rules -Homeservers can specify "server-default rules" which operate at a lower -priority than "user-defined rules". The `rule_id` for all server-default -rules MUST start with a dot (".") to identify them as "server-default". -The following server-default rules are specified: +Homeservers can specify "server-default rules". They operate at a lower +priority than "user-defined rules", except for the `.m.rule.master` rule +which has always a higher priority than any other rule. The `rule_id` +for all server-default rules MUST start with a dot (".") to identify +them as "server-default". The following server-default rules are +specified: ###### Default Override Rules **`.m.rule.master`** Matches all events. This can be enabled to turn off all push -notifications other than those generated by override rules set by the -user. By default this rule is disabled. +notifications. Unlike other server-default rules, this one has always a +higher priority than other rules, even user defined ones. By default this +rule is disabled. Definition: