From 9d57e9a4fe404b401b744bc2ee2132e2d42b4cab Mon Sep 17 00:00:00 2001 From: Bhumika Garg Date: Sat, 28 Mar 2026 02:15:12 +0530 Subject: [PATCH 1/2] Clarify comment notification behavior and owner-specific muting rules in Kanvas docs Signed-off-by: Bhumika Garg --- content/en/kanvas/designer/comments/index.md | 25 ++++++++++++++++---- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/content/en/kanvas/designer/comments/index.md b/content/en/kanvas/designer/comments/index.md index 7f28e383d..f8dec517b 100644 --- a/content/en/kanvas/designer/comments/index.md +++ b/content/en/kanvas/designer/comments/index.md @@ -201,11 +201,17 @@ Each time that a new comment is made in a design, remark placed into existing co
Example email notification received when design comment is made.
-As the owner of a design, you will recieve notification each time a comment is made in your design. Tag other users and have them receive notificaiton of your comment by mentioning their username with the `@` symbol. +As the owner of a design, you will receive notification each time a comment is made in your design. + +**Note:** +- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely +- Thread-level muting does not suppress notifications for design owners + +Tag other users and have them receive notification of your comment by mentioning their username with the `@` symbol. All users participating in a comment will be notified as new remarks are added in a comment thread. -As new comments are added into the your design, collaborators (other users) with which you have shared the design, will not receive notification unless they are tagged in that comment. +As new comments are added into your design, collaborators (other users) with which you have shared the design, will not receive notification unless they are tagged in that comment. ### Enable Email Notifications @@ -215,6 +221,9 @@ Customize your [notification preferences](/cloud/identity/users/notification-pre Customize your notification preferences to mute email notifications for comments on your design. With notifications for new comments silenced, you won't receive email notifications for new comments on your design. This can be useful if you want to temporarily pause notifications or reduce email clutter. +**Note:** +- Thread-level muting does not suppress notifications for design owners +
Turn Off notification from comments in designer
Example of comments in Designer
@@ -222,6 +231,9 @@ Customize your notification preferences to mute email notifications for comments You can also manage all your comment notification settings centrally through the **Cloud -> Account -> [Preference](https://docs.layer5.io/cloud/identity/users/notification-preferences/)**. +**Note:** +- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely +
Manage comment notifications in the Cloud Portal
Manage all comment notifications centrally in the Cloud
@@ -235,15 +247,18 @@ You can also manage all your comment notification settings centrally through the #### What Muting Doesn't Affect - **Mentions in Other Designs:** You'll still be notified if someone mentions you in new or existing comment threads on other designs in your portfolio. -- **New Comment Threads:** Muting only applies to the specific comment thread it's activated on. New threads on the same design will trigger notifications as usual. +- **New Comment Threads:** Muting applies only to the specific thread where it is activated. +New threads on the same design follow the standard notification rules: + - Design owners will receive notifications + - Users will receive notifications only if they are participants in the thread or are explicitly mentioned -{{< alert title="Muted Notifcations Reminder">}} +{{< alert title="Muted Notifications Reminder">}} - While email alerts are muted, you can still access and view all comments on the design at any time. - You'll never miss an important mention, as notifications for mentions outside the muted thread remain active. {{< /alert >}} -{{< alert type="info" title="Missed Notifcations">}} +{{< alert type="info" title="Missed Notifications">}} Kanvas does not track the read or unread status of messages inside comment threads for each user. If a user is mentioned, but misses the notification, they might not become aware of the comment until they receive a new notification for another comment in that conversation. {{< /alert >}} From b8cbeb855d5ab18546bf4dd479c635138a1d1850 Mon Sep 17 00:00:00 2001 From: Bhumika Garg Date: Sat, 28 Mar 2026 22:33:54 +0530 Subject: [PATCH 2/2] add alert Signed-off-by: Bhumika Garg --- content/en/kanvas/designer/comments/index.md | 29 +++++++++++--------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/content/en/kanvas/designer/comments/index.md b/content/en/kanvas/designer/comments/index.md index f8dec517b..39500e8e5 100644 --- a/content/en/kanvas/designer/comments/index.md +++ b/content/en/kanvas/designer/comments/index.md @@ -203,10 +203,6 @@ Each time that a new comment is made in a design, remark placed into existing co As the owner of a design, you will receive notification each time a comment is made in your design. -**Note:** -- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely -- Thread-level muting does not suppress notifications for design owners - Tag other users and have them receive notification of your comment by mentioning their username with the `@` symbol. All users participating in a comment will be notified as new remarks are added in a comment thread. @@ -221,23 +217,28 @@ Customize your [notification preferences](/cloud/identity/users/notification-pre Customize your notification preferences to mute email notifications for comments on your design. With notifications for new comments silenced, you won't receive email notifications for new comments on your design. This can be useful if you want to temporarily pause notifications or reduce email clutter. -**Note:** -- Thread-level muting does not suppress notifications for design owners -
Turn Off notification from comments in designer
Example of comments in Designer
-You can also manage all your comment notification settings centrally through the **Cloud -> Account -> [Preference](https://docs.layer5.io/cloud/identity/users/notification-preferences/)**. +{{< alert type="info" title="Thread-level Muting Behavior">}} +Muting a comment thread applies to participants in that thread. + +Design owners will continue to receive notifications for all activity within their design. +{{< /alert >}} -**Note:** -- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely +You can also manage all your comment notification settings centrally through the **Cloud -> Account -> [Preference](https://docs.layer5.io/cloud/identity/users/notification-preferences/)**.
Manage comment notifications in the Cloud Portal
Manage all comment notifications centrally in the Cloud
+{{< alert type="info" title="Global Notification Preferences">}} +Notification preferences set in Cloud apply across all designs. + +Disabling notifications using preferences will stop email notifications for both owners and collaborators. +{{< /alert >}} #### What Muting Affects @@ -248,9 +249,11 @@ You can also manage all your comment notification settings centrally through the - **Mentions in Other Designs:** You'll still be notified if someone mentions you in new or existing comment threads on other designs in your portfolio. - **New Comment Threads:** Muting applies only to the specific thread where it is activated. -New threads on the same design follow the standard notification rules: - - Design owners will receive notifications - - Users will receive notifications only if they are participants in the thread or are explicitly mentioned + + New threads on the same design follow standard notification behavior: + + - Design owners receive notifications for all comment activity + - Users receive notifications only if they are participants in the thread or are explicitly mentioned {{< alert title="Muted Notifications Reminder">}}