← Help center · Automations & agents

How to start a workflow when someone adds a comment

Updated Nov 14, 2026

Use the Comment added trigger to start a workflow each time someone comments on a record in a sheet. The workflow can answer with the Add comment step. For example, when a client comments from your portal, it leaves an internal note on the record that mentions their account manager. Owners, admins and members can build it. Workflows come with the Pro plan and up (see pricing).

Before you start

  • Your workspace is on Pro, Business or Enterprise. On Free you can build and save the workflow, but publishing it opens Automations need Pro.
  • You're an owner, admin or member of the workspace; guests can't build workflows. You can change the workflows you created, and owners and admins can change any workflow.

Add the Comment added trigger

  1. Open the sheet and choose Workflows at the top.
  2. Choose Start from scratch. On a sheet that already has workflows, choose + next to their tabs first.
  3. In the Node library, under Triggers, choose Comment added. It watches the sheet you're in.
  4. Choose the trigger on the canvas, then Configure, the gear above it.
  5. In Written by, choose whose comments start the workflow: Anyone, Members, or Customers, who comment from your portal.
  6. Choose Save.

Answer with a comment

The Add comment step posting an internal note in the comment's thread
The Add comment step posting an internal note in the comment's thread
  1. In the Node library, under Actions, choose Add comment. As the first step after the trigger, it connects to the trigger by itself.
  2. Choose the step, then Configure.
  3. In Item ID, choose Insert variable, the button at the end of the field, and pick Item ID under Comment added.
  4. In Comment, type the text. To add a value from the comment, such as Comment text or Author name, choose Insert variable beside the field and pick it under Comment added.
  5. Optional: in Mention, pick the members to @mention. They get a notification.
  6. In Visibility, keep Public, or choose Internal note so customers in your portal don't see the comment.
  7. Optional: turn on Reply in thread to answer inside the thread of the comment that started the run.
  8. Choose Save.
  9. Choose Publish at the top of the builder.

Each new comment on a record in the sheet now runs the workflow. The workflow's comment appears on the record under the workflow's name, marked Workflow, or inside the comment's thread when Reply in thread is on.

Also move the record to a new status

A workflow can change the record too. To set its status to Needs reply, for example, each time a client comments:

  1. In the Node library, under Actions, choose Update Item.
  2. Drag from the dot at the bottom of the Add comment step to the new step.
  3. Choose the new step, then Configure.
  4. In Item ID, choose Insert variable and pick Item ID under Comment added.
  5. Under Field Values, pick your status field, then its new value in Value.
  6. Choose Save.
  7. Choose Publish changes at the top of the builder.

What starts it

  • A new comment on any record in the sheet, from a member in Atwork or from a customer in your portal.
  • Replies in a thread and internal notes are new comments too. Is a reply and Internal note tell them apart in later steps.
  • Comments written by workflows and AI agents never start it, so the workflow's own comment doesn't start it again.
  • Comments on pages don't start it, and neither do comments on an archived record.

What later steps can use

Under Comment added, Insert variable lists the record and the comment:

VariableWhat it holds
Item IDThe record that got the comment
The sheet's fields, such as TitleThat record's values
Comment textThe comment as plain text
Author nameThe member who wrote it. Empty when a customer wrote it
Author kindmember or customer
AuthorThe ID of the member or customer who wrote it
MentionsThe members the comment @mentions
Is a replyWhether the comment is a reply in a thread
Internal noteWhether the comment is an internal note
Comment ID, Thread IDThe IDs of the comment and of its thread

Good to know

  • Add comment works after any trigger, such as Field Changed. Reply in thread only applies when the run started from Comment added on the same record; otherwise the step starts a new comment.
  • A reply in an internal note's thread is always an internal note, so customers don't see it.
  • Members you mention who can't open the sheet get no notification.
  • To comment on a record in another sheet, pick that sheet in Sheet and give an Item ID from that sheet.
  • To see each run, open the workflow and choose Executions, the history icon in the builder's toolbar. See Test and debug an automation.

Related: Automation triggers · Automation actions · Comments and mentions · Test and debug an automation

Related articles

How to send Dana a voice message
Click the microphone in Dana's chat, say your request in Farsi or English, then check the text Dana transcribes and send it. Pro plan and up.
How to run a workflow from a button on a row
Add an Action Button field to an Atwork sheet so each row gets a button that runs a workflow with that row's Item ID, Status or other values.
Choose which connections an agent can use
Choose which connected accounts an Atwork agent may use and at what level, how members consent to their own accounts, and how to revoke an agent's access.