Skip to main content

Comment on collected records action

Add the same comment to every record in a collected list in one step, for example tell all open tasks of a sprint that the sprint is over now.

Written by Leo

Comment on collected is an action that adds a comment to every record in a list of collected records. In the action list, its description reads Add a comment to all collected records. It's meant to help you leave a note on many records at once, without building a loop.

You can use this action for many things, including:

  • Commenting on all open tasks of a sprint when the sprint is closed.

  • Telling every delivery record of an order that the invoice was paid.

The action Add a comment to all collected records in Expenses below Search for records, with an empty Value box

Note:

  • Collect first. The action works on records that an earlier action collected, for example Search for records, Get view, or Get related. Without a collection, Select collected records shows No results.

  • Each collecting action adds up to 1,000 records. If more records match, the rest are left out without a warning, and only the collected records get the comment. If several actions collect from the same database app, their records add up in one collection.

  • People can be notified. Unless you turn on Silent, each comment notifies everyone who follows the record. People you mention with @ are notified even if they don't follow the record. The person set under Author isn't notified about their own comment.

Who can use the Comment on collected action?

  • Automations are available on all plans: Free, Plus, and Premium. The number of automation actions per month depends on your plan. See the limits for your plan on our pricing page.

  • To add or change this action, you need to be a Workspace admin of the workspace the database app is in. App permissions alone aren't enough.

Add the Comment on collected action

To comment on collected records from an automation:

  1. Open the database app and click the automations icon at the top right (Create and view automations).

  2. Open an automation, or select New automation and choose a trigger.

  3. Add an action that collects records, for example Add action → Search for records.

  4. Select Add action → Comment on collected. The step appears as Add a comment to all collected records.

  5. Next to in, check the collection. Tape preselects the nearest collection above this action. To change it, select its name. Without a collection, it reads Select collected records.

  6. Write the comment in the text box. Type @ to insert record values.

  7. Select Save changes. For a new automation, the button reads Create automation.

Adding Comment on collected below Search for records in an Expenses automation: Add action, selecting Comment on collected, pointing to Expenses after in, then typing Please check the receipt from and choosing Vendor after @

Comment on collected settings

  • Select collected records: the collection to comment on. The list shows the collections created by actions above this one.

  • The comment: the text of the comment. You can mix text with record values, for example the title of the record that started the automation. The placeholder in the text box is Value. The comment should not be empty, or the action is skipped.

  • Values of each record: you can insert values of each collected record. Each record gets its own values in the comment.

  • Format: the comment is plain text. Type @ to insert values or mention people. Formatting and attachments aren't supported.

Select collected records is the only required setting.

Under the action's menu, Settings has these options:

  • Author: who the comments are attributed to. If you don't choose one, they're attributed to the automation itself. To choose one, open the action's menu ••• and select Author. Choose a member of the workspace, or a person field such as Created by.

  • Silent: adds the comments without sending notifications. Without it, the comments notify the same people as a comment from a person: everyone who follows the record and everyone mentioned in the comment.

  • Trigger automations: lets the comments start other automations, for example one with the trigger When a comment is added.

  • Trigger webhooks: lets the comments send outbound webhooks.

Silent, Trigger automations, and Trigger webhooks are off when you add the action.

The menu also has Continue on error, Deactivate, Turn into, Duplicate, and Remove. Learn more about action settings →

Let's look at an example

Let's say your team closes a sprint and wants every unfinished task to say so. Here's how:

  1. Set the trigger to When a record is updated in the database app Sprints and select the field Status.

  2. Add the filter Where Status Has changed to "Closed".

  3. Select Add action → Search for records, select the database Tasks, and add a filter so only tasks with the status "Open" are collected.

  4. Select Add action → Comment on collected. Tape preselects the collection from step 3.

  5. Write the comment “Sprint closed. This task wasn't finished and needs a new date.”

  6. Select Save changes.

When a sprint is closed, every open task gets that comment.

Comment on collected errors

  • If the step fails, the run shows the step and its message in the automation's runs. Open the automation and select ▷ next to Manual run (View all runs, cmd/ctrl + 1). Each run shows its status, for example Success; select a run to see every step. For all automations, open Runs in the Automation Center and filter by App, Automation, or Status.

  • If Select collected records shows No results, add a collecting action above this one.

  • If the comment is empty, the action is skipped and no comments are added.

Test, pause, or edit the Comment on collected action

  • Manual run runs the automation once. It appears after the automation is saved. Under Run on, select the records, then select Start run (Save and start run if you have unsaved changes). The comments are added to the real records.

  • New automations you create in the editor are Active right away. The status, Active or Paused, sits below the automation's name in the editor. To pause one, select the status to switch it to Paused, then select Save changes.

  • To change the action, open the automation, select the Add a comment to all collected records step, make your changes, then select Save changes.

Learn more

FAQs

What's the difference between Add comment and Comment on collected?

Add comment writes a comment on one record, usually the one that started the automation. Comment on collected writes the same comment on every record in a collection. Learn more about Add comment →

Do I need a loop to comment on many records?

No. Comment on collected adds the comment to all collected records in one step. Use a loop only when each record needs extra steps. Learn more about loops →

Who is shown as the author of the comment?

By default, the automation itself. You can choose another author in the action's Settings.

Can I comment on only some of the collected records?

Yes! Use Filter collected before Comment on collected to keep only the records that match a condition. Learn more about filtering collected records →

Are there other actions I can use?

Yes! Actions can create and update records, add comments, send emails, create PDFs, call other services, and more. See every action in Automation actions →

Are you a developer using the Tape API for automations?

The automation API has its own documentation for developers. Full reference: collected_records_comment_create in the developer docs →

Still have questions? Find answers and get help from community experts in the Tape community →

Did this answer your question?