Diff

--- a/mod_push2/push2.md	Sun Jun 01 11:41:42 2025 +0700
+++ b/mod_push2/push2.md	Sun Jun 01 11:43:16 2025 +0700
@@ -15,6 +15,10 @@
     <service>pusher@push.example.com</service>
     <client>https://push.example.com/adlfkjadafdasf</client>
     <match profile="urn:xmpp:push2:match:archived-with-body">
+        <grace>144</grace>
+        <filter jid="somemuc@conference.example.com">
+            <mention/>
+        </filter>
         <send xmlns="urn:xmpp:push2:send:notify-only:0"/>
     </match>
 </enable>
@@ -26,6 +30,10 @@
 
 The `<match/>` and `<send/>` elements define what profiles to use for matching stanzas and sending notifications. These are described later in this document.
 
+The optional `<filter/>` child of `<match/>` allows extra filtering of pushes for only specific chats. No specified filters means muted, do not push. `<mention/>` means push on mentions, `<reply/>` means push on replies.
+
+The optional `<grace/>` child of `<match/>` allows specifying a "grace period" in seconds where activity on another session by the same user (such as sending a message) will temporarily pause sending push notifications.
+
 ## Match and send profiles
 
 Different clients and push services have different requirements for push notifications, often due to the differing capabilities of target platforms.