Skip to main content

Comments: Collaborating with your team

Learn how to use Comments to facilitate discussions and share updates within steps in Puzzle.

Brian Ragone avatar
Written by Brian Ragone
Updated over 2 months ago

Effective communication is key to smooth collaboration, especially when managing complex workflows. Puzzleโ€™s Comments feature allows teams to centralize discussions directly within process steps, ensuring all conversations stay relevant, organized, and actionable.

Whether you need to ask a question, share feedback, document decisions, or highlight challenges, Comments make it easy to keep your team aligned without losing context.

By integrating discussions into specific steps, Puzzle eliminates scattered messages and misplaced conversations, making process collaboration more efficient. With tagging, categorization, and notifications, your team can stay informed and engagedโ€”even when working asynchronously.


Benefits of Using Comments

๐Ÿค Collaboration: Easily foster discussions within your workflows by attaching comments to specific steps.

๐Ÿ“ Contextual Communication: Ensure all comments are relevant to the task at hand, avoiding miscommunication or misplaced conversations.

๐Ÿ“ Documentation: Keep a record of decisions, discussions, and updates for transparency and future reference.


Video Guide: Collaborating with your team


Step-by-Step Guide

1๏ธโƒฃ Adding A Comment

  • ๐Ÿ’ฌ Add Comment: To add a comment, click the speech bubble icon next to the step you want to discuss.

  • ๐Ÿ”– Categorize Comment: Choose a category from the dropdown menu to better organize your comments. Available categories include:

    • Note ๐Ÿ“Œ โ€“ General observations or additional context.

    • Decision โœ… โ€“ Important choices made during the process.

    • Pain Point โš ๏ธ โ€“ Issues or blockers that need attention.

    • Idea ๐Ÿ’ก โ€“ Suggestions for improvements.

    • Question โ“ โ€“ Inquiries that require clarification.

  • โœ๏ธ Provide Details: Type your comment and submit. Comments will now appear in the thread linked to that specific step.

  • ๐Ÿ‘ฅ Tag Team Members: Use @ followed by a teammateโ€™s name to tag them in a comment. This ensures they are notified and can quickly respond to important discussions.

๐Ÿ”” Notifications:ย Puzzle will send an email notification when you are mentioned in a comment, so you can stay updated even if you are away from the platform.

2๏ธโƒฃ Replying to Comments

  • ๐Ÿ’ฌ Keep the Conversation Going: To reply, click on an existing comment and type your response. This enables a threaded discussion, ensuring all feedback and insights stay in one place.

  • โœ… Resolve & Reopen Comments:

    • Resolve: When a discussion is complete, mark the comment as resolved to disable replies and clear it from active notifications.

    • Reopen: Need to revisit a past conversation? Click the reopen button to resume the discussion.

3๏ธโƒฃ Viewing All Comments

  • ๐Ÿ“œ View Comments: In the Workflow sidebar, click the comment icon to view a list of all comments associated with the entire workspace.

  • โž• Similarly, in the Section sidebar, click the comment icon to view a list of all the comments associated with steps that are grouped within the section.

  • ๐Ÿ“ Navigate Easily: Clicking a specific comment from the list will take you directly to the relevant step, helping you quickly access and manage comments across your workflows.


๐Ÿ’ก Important Tips & Best Practices

๐Ÿ”– Organize Discussions: Use the dropdown menu to categorize comments for clarity and purpose in discussions.

๐Ÿ” Comments Roll-up: Individual step comments will automatically roll up to the Section comments tab. This feature allows for easy review of all comments related to a process section without losing track of their original placement.

๐ŸŽฅ Add Walkthroughs: Enhance communication by adding a Loom video walkthrough in the comments to visually explain a process step or provide additional context.

๐Ÿ“… Regularly Review Comments: Make it a practice to regularly check and reply to comments to keep discussions flowing and ensure important updates are addressed on time.


Conclusion

Puzzleโ€™s Comments feature makes collaboration effortless by keeping discussions directly connected to workflow steps. With built-in tagging, categorization, and notifications, your team can quickly share insights, document key decisions, and stay informed without losing context.

Whether youโ€™re addressing feedback, resolving questions, or tracking important updates, Comments ensure seamless communication and better workflow management.

Start using Puzzle Comments today to enhance your teamโ€™s collaboration and keep every conversation exactly where it belongs. ๐Ÿš€

Did this answer your question?