AperioFlow Start free

Docs Planning work

Comments and mentions

Every task and subtask has a comment thread at the bottom of its editor, for the conversation about the work. Comments need a personal sign in: an API key that is not tied to a person cannot comment.

Write a comment

  1. Open the task or subtask (the pencil on its row, or click its name).
  2. Type in Write a comment. Markdown works. (up to 10,000 characters).
  3. Choose Comment.

Comments are listed oldest first, with the author and when it was written. A comment that was changed says "(edited)". A comment whose author's account was deleted shows "Deleted user".

The Comments section of a task with two comments from Alex Morgan and the Write a comment box ringed.
Comments at the bottom of the task editor. Markdown works.

Format with Markdown

Comments understand Markdown: headings, bold, italic, inline code, code blocks, links, lists, quotes and tables. HTML typed into a comment is shown as text, never run.

Task descriptions are plain text; only comments are formatted.

Mention a teammate

Choose Mention someone... and pick a member to put "@Name" into the comment, or type it yourself. When you press Comment, each person still named is told: a mention emails that person (they can switch these emails off). The email names you and links to the task; it never repeats your comment. Up to 20 people can be mentioned in one comment.

Edit or delete a comment

  • Edit: only the author can change a comment. Choose Edit, change the text, then Save.
  • Delete: the author, or an admin or owner, can delete a comment after confirming.

The activity log records that a comment was added, never what it said.

Start free All the docs Video guides

Built for the people who write the code and answer the phone when it breaks.

Run from the UK. Hosted in France.

UK time --:--

Already in?Open the app Start free today
View our policies