Skip to content

Commit 9d57e9a

Browse files
committed
Clarify comment notification behavior and owner-specific muting rules in Kanvas docs
Signed-off-by: Bhumika Garg <bhumikatech2024@gmail.com>
1 parent 9bed52b commit 9d57e9a

1 file changed

Lines changed: 20 additions & 5 deletions

File tree

  • content/en/kanvas/designer/comments

content/en/kanvas/designer/comments/index.md

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -201,11 +201,17 @@ Each time that a new comment is made in a design, remark placed into existing co
201201
<figcaption>Example email notification received when design comment is made.</figcaption>
202202
</figure>
203203

204-
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.
204+
As the owner of a design, you will receive notification each time a comment is made in your design.
205+
206+
**Note:**
207+
- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely
208+
- Thread-level muting does not suppress notifications for design owners
209+
210+
Tag other users and have them receive notification of your comment by mentioning their username with the `@` symbol.
205211

206212
All users participating in a comment will be notified as new remarks are added in a comment thread.
207213

208-
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.
214+
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.
209215

210216
### Enable Email Notifications
211217

@@ -215,13 +221,19 @@ Customize your [notification preferences](/cloud/identity/users/notification-pre
215221

216222
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.
217223

224+
**Note:**
225+
- Thread-level muting does not suppress notifications for design owners
226+
218227
<figure>
219228
<img src="./comment-notificationBell.png" alt="Turn Off notification from comments in designer" style="width:auto">
220229
<figcaption>Example of comments in Designer</figcaption>
221230
</figure>
222231

223232
You can also manage all your comment notification settings centrally through the **Cloud -> Account -> [Preference](https://docs.layer5.io/cloud/identity/users/notification-preferences/)**.
224233

234+
**Note:**
235+
- Global notification preferences (Cloud settings) are respected for design owners and can be used to disable notifications entirely
236+
225237
<figure>
226238
<img src="./comment-cloud-manage.png" alt="Manage comment notifications in the Cloud Portal" style="width:auto">
227239
<figcaption>Manage all comment notifications centrally in the Cloud</figcaption>
@@ -235,15 +247,18 @@ You can also manage all your comment notification settings centrally through the
235247
#### What Muting Doesn't Affect
236248

237249
- **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.
238-
- **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.
250+
- **New Comment Threads:** Muting applies only to the specific thread where it is activated.
251+
New threads on the same design follow the standard notification rules:
252+
- Design owners will receive notifications
253+
- Users will receive notifications only if they are participants in the thread or are explicitly mentioned
239254

240-
{{< alert title="Muted Notifcations Reminder">}}
255+
{{< alert title="Muted Notifications Reminder">}}
241256

242257
- While email alerts are muted, you can still access and view all comments on the design at any time.
243258
- You'll never miss an important mention, as notifications for mentions outside the muted thread remain active.
244259
{{< /alert >}}
245260

246-
{{< alert type="info" title="Missed Notifcations">}}
261+
{{< alert type="info" title="Missed Notifications">}}
247262
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.
248263
{{< /alert >}}
249264

0 commit comments

Comments
 (0)