{"id":5734,"date":"2024-07-01T08:00:40","date_gmt":"2024-07-01T08:00:40","guid":{"rendered":"https:\/\/www.process.st\/help\/docs\/comments\/"},"modified":"2024-08-13T12:55:47","modified_gmt":"2024-08-13T12:55:47","slug":"comments","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/comments\/","title":{"rendered":"How to Use Comments"},"content":{"rendered":"<p>Comments are a great way to communicate with the rest of your team when working through <a href=\"https:\/\/www.process.st\/help\/docs\/tasks\/#tasks\">tasks<\/a> in My Work or tasks on <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-a-workflow-run\/\">workflow runs<\/a>.<\/p>\n<p>You can @mention others or yourself to send them an instant comment or <a href=\"https:\/\/www.process.st\/help\/docs\/email-notifications\/\">email notification<\/a>, format your comments with <a href=\"https:\/\/www.process.st\/help\/docs\/format-comments\/\">markdown text<\/a>, and attach files to your comments.<\/p>\n<p>Better still, you can use <a href=\"https:\/\/www.process.st\/help\/kb\/integrations\/\">integrations<\/a> to post comments, @mention other users or yourself, and add attachments.<\/p>\n<p><em><strong>Users: All users can add comments and upload files to comments.<\/strong><\/em><\/p>\n<p><iframe loading=\"lazy\" src=\"https:\/\/www.youtube.com\/embed\/mZSgDmE9HFI\" width=\"100%\" height=\"406\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span><\/iframe><\/p>\n<h2>Where to view and create comments<\/h2>\n<p>You can access comments by clicking the comments icon in the top right corner of your screen.\u00a0 Here you can find all the mentions and threads of conversations you\u2019re a part of.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7693\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-tab.png\" alt=\"\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-tab.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-tab-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-tab-768x384.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>A red dot on your comments icon indicates that you have new unread comments, which appear at the top of your comments inbox. Comments you\u2019ve read appear below in date order, from the date they were created.<\/p>\n<p>You can mark all your comments as &#8216;read&#8217;, or open them up to reply to them.<\/p>\n<p>Interacting with a comment marks it as read when you:<\/p>\n<ul>\n<li>Click view<\/li>\n<li>Open the task\/page<\/li>\n<li>Reply to it<\/li>\n<\/ul>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7694\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-reply.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h3>Tasks in workflow runs<\/h3>\n<p>At the bottom of each task in a workflow run, you\u2019ll see the comment box and above that, any comments or attachments that have already been posted.<\/p>\n<p>To leave a comment you first need to go to a workflow run and then go to the task where you want to add a comment.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7701\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-in-a-run.png\" alt=\"\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-in-a-run.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-in-a-run-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-in-a-run-768x384.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>Scroll to the bottom of the task to see the comment box. You can post new comments here and @ mention other users in your organization then click &#8220;<strong>Send<\/strong>&#8221; to post it, as shown above.<\/p>\n<p>To attach a file to a comment, drag and drop your file into the comments field, or click on the &#8220;<strong>Paper Clip Icon<\/strong>&#8221; at the bottom of the comment box, select your file, and confirm.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7696\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-files.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>The file you upload will appear in the comment thread, as shown above.<\/p>\n<p><em><strong>Note:<\/strong> There is no storage cap on the number of files you can upload, there are individual <a href=\"https:\/\/www.process.st\/help\/docs\/file-upload-limits\/\">file upload limits<\/a>.<\/em><\/p>\n<p>Want to post formatted comments instead of plain text? Learn how to format them with <a href=\"https:\/\/www.process.st\/help\/docs\/format-comments\/\">markdown<\/a>.<\/p>\n<h3>Workflow runs<\/h3>\n<p>If you&#8217;re looking for a specific comment in a workflow run but you&#8217;re not sure of the task where it was posted, you can view all the comments added to that workflow run at once.<\/p>\n<p>You\u2019ll see the comments icon in the right-hand menu of your workflow runs. If there are no comments on the run, this will be greyed out. If there are any comments, you can click the icon and see the comments in a list.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7697\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wfr-menu.png\" alt=\"\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wfr-menu.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wfr-menu-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wfr-menu-768x384.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h3>Tasks attached to workflow runs<\/h3>\n<p>You can add comments to <a href=\"https:\/\/www.process.st\/help\/docs\/tasks\/#attached-tasks\">tasks attached<\/a> to workflow runs. These comments behave the same way as in your workflow tasks, mentioned above.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7726\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/03\/comments-attached-task.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h3>Tasks from My Work<\/h3>\n<p>You can also add comments to <a href=\"https:\/\/www.process.st\/help\/docs\/tasks\/#tasks\">tasks<\/a> in My Work, in the same way as mentioned above.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7727\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/03\/comments-my-work.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h3>Reports<\/h3>\n<p>If you&#8217;re looking for a particular conversation that happened in a workflow run, you can identify all the workflow runs with comments, at a glance.<\/p>\n<p>While viewing your <a href=\"https:\/\/www.process.st\/help\/docs\/reports\/\">Reports<\/a> dashboard, you can see which workflow runs have comments in them by using a column filter. Click the comments icon to see a roll-up of all the comments on that workflow run, as shown below.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7698\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-reports.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h3>Workflows<\/h3>\n<p>While editing a workflow, you can view the comments added to runs to assess the efficiency of your workflow or review any changes it might need.<\/p>\n<p>Go to the workflow editor and click the comments icon in the header bar (black bar). This shows you all the comments and the workflow runs to which they were added.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7699\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wf-editor.png\" alt=\"\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wf-editor.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wf-editor-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wf-editor-768x384.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>You can navigate to the task to see the comment in context.<\/p>\n<h2>How to disable comments on workflow runs<\/h2>\n<p>Comments are shown on all tasks in workflow runs by default.<\/p>\n<p>You can disable comments on a workflow when editing it, which means that all of the workflow runs created from it will have the comments disabled.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7700\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-disable.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Click the <strong>cog<\/strong> icon in the editor settings and use the toggle switch to disable or re-enable comments, then click <strong>Save<\/strong> to finish, as shown above.<\/p>\n<h2>@Mentioning users in comments<\/h2>\n<p>By @mentioning a user in your organization in a comment, your comment appears in their comments inbox. This is a great way to prompt a user to come and work on an urgent task or workflow run.<\/p>\n<p>Do this by typing \u201c@\u201d into your comment, followed by the user\u2019s name or email address. Once you see the correct user\u2019s profile picture and name, click that entry to add them to your comment. Click \u201c<strong>Send<\/strong>\u201d to post.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-7695\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2022\/09\/comments-wfr.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>If that person replies to your comment, you\u2019ll be automatically subscribed so they don\u2019t need to @ mention you back for you to see the comment.<\/p>\n<p><strong>Note:<\/strong>\u00a0When you @mentioning a user in a comment, it also sends them an instant\u00a0<a href=\"https:\/\/www.process.st\/help\/docs\/email-notifications\/\">email notification<\/a>. If your emails get too noisy, you can always manage which notifications are sent from your <a href=\"https:\/\/www.process.st\/help\/docs\/managing-user-profile\/\">user profile<\/a>.<\/p>\n<p>The following rules apply when you @mentioning other users:<\/p>\n<ul>\n<li>Users must have verified email addresses and be part of your organization<\/li>\n<li>User names must be unique<\/li>\n<li>User names must not contain special characters<\/li>\n<li>You can @mention yourself to make notes or remind yourself about something<\/li>\n<li>Users must either be assigned to the workflow run or a task within it or have &#8220;view all&#8221; permission to the workflow to be able to reply to comments freely<\/li>\n<\/ul>\n<h2>Comments, attachments and @mentions via integrations<\/h2>\n<p>You can also add comments and comment attachments to tasks in your workflow runs when using an integration with <a href=\"https:\/\/zapier.com\/\">Zapier<\/a>, as shown below.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11147\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Comments-via-Zapier2.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p><em><strong>Note:<\/strong> This is only available for workflow run tasks at the moment.<\/em><\/p>\n<p>If you add @ before a user\u2019s name in Zapier, shown above, this effectively works the same as when you manually @mention someone.<\/p>\n<p>The resulting comment will show that it has been posted by Zapier in your workflow run:<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11146\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Zapier-comment.png\" alt=\"\" width=\"50%\" \/><\/p>\n<p>You can also @mention users, use @here or @channel when using the <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">snippet form field<\/a> with Process Street&#8217;s <a href=\"https:\/\/www.process.st\/help\/docs\/slack\/\">Slack integration<\/a>.<\/p>\n<h3>What happens if I delete or archive something?<\/h3>\n<p>If you delete a comment it\u2019s removed from the comments inbox of anyone you mentioned, or anyone who\u2019s part of a thread.<\/p>\n<p>If you delete or archive a workflow run or workflow the comments will remain in the relevant user&#8217;s comments inbox but they won&#8217;t be able to reply to them or individually mark them as read unless they click &#8216;Mark all as read&#8217;.<\/p>\n<p>If comments have been made on a workflow run and then comments get disabled on the workflow, then these will also remain in the relevant user&#8217;s comments inbox. Re-enabling comments will allow the mentioned users to act on them.<\/p>\n<h2>Auto-subscribe to comments<\/h2>\n<p>If you take part in a conversation, even if you don\u2019t @mention someone, you\u2019ll get the replies straight into your comments inbox. You are effectively auto-subscribed to that thread.<\/p>\n<p>This works on <a href=\"https:\/\/www.process.st\/help\/docs\/email-notifications\/\">email notifications<\/a>, <a href=\"https:\/\/www.process.st\/help\/docs\/slack-app\/\">Slack app<\/a>, and <a href=\"https:\/\/www.process.st\/help\/docs\/microsoft-teams-app\/\">Teams app<\/a> notifications. If your notifications are getting too noisy, you can always adjust your settings.<\/p>\n<h2>Comments and task permissions<\/h2>\n<p>If you can see a comment in your inbox, but cannot click through to the task or workflow run, is likely due to permissions.<\/p>\n<p>If there are\u00a0<a href=\"https:\/\/www.process.st\/help\/docs\/task-permissions\/\">task permissions<\/a>\u00a0in place so that a certain user <em>does not<\/em> have permission to see a task, they <em>will<\/em> receive an @mention comment notification but they won&#8217;t be able to act on it until they are assigned to that task or are given permission to view that workflow run.<\/p>\n<p>If you or someone else in your team is not receiving emails or notifications for comments, it&#8217;s likely due to permissions or the email notification settings in their profile. Speak to your admin or the workflow creator to grant you access to the workflow or adjust your settings.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Comments are a great way to communicate with the rest of your team when working through tasks in My Work or tasks on workflow runs. You can @mention others or yourself to send them an instant comment or email notification, format your comments with markdown text, and attach files to your comments. Better still, you [&hellip;]<\/p>\n","protected":false},"author":3,"template":"","meta":{"_acf_changed":false,"available_plan":"All plans","available_product":"Workflows","footnotes":""},"ht_kb_category":[168],"ht_kb_tag":[287,187],"class_list":["post-5734","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-run-workflows","ht_kb_tag-comments","ht_kb_tag-workflow-runs"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5734","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/3"}],"version-history":[{"count":7,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5734\/revisions"}],"predecessor-version":[{"id":8343,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5734\/revisions\/8343"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=5734"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=5734"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=5734"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}