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.
Note:
Collect first. The action works on records that an earlier action collected, for example
Search for records,Get view, orGet related. Without a collection,Select collected recordsshowsNo 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 underAuthorisn'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 adminof 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:
Open the database app and click the automations icon at the top right (
Create and view automations).Open an automation, or select
New automationand choose a trigger.Add an action that collects records, for example
Add action→Search for records.Select
Add action→Comment on collected. The step appears asAdd a comment to all collected records.Next to
in, check the collection. Tape preselects the nearest collection above this action. To change it, select its name. Without a collection, it readsSelect collected records.Write the comment in the text box. Type
@to insert record values.Select
Save changes. For a new automation, the button readsCreate automation.
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 selectAuthor. Choose a member of the workspace, or a person field such asCreated 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 triggerWhen 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:
Set the trigger to
When a record is updatedin the database appSprintsand select the fieldStatus.Add the filter
WhereStatusHas changed to"Closed".Select
Add action→Search for records, select the databaseTasks, and add a filter so only tasks with the status "Open" are collected.Select
Add action→Comment on collected. Tape preselects the collection from step 3.Write the comment “Sprint closed. This task wasn't finished and needs a new date.”
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 toManual run(View all runs,cmd/ctrl+1). Each run shows its status, for exampleSuccess; select a run to see every step. For all automations, openRunsin the Automation Center and filter byApp,Automation, orStatus.If
Select collected recordsshowsNo 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 runruns the automation once. It appears after the automation is saved. UnderRun on, select the records, then selectStart run(Save and start runif you have unsaved changes). The comments are added to the real records.New automations you create in the editor are
Activeright away. The status,ActiveorPaused, sits below the automation's name in the editor. To pause one, select the status to switch it toPaused, then selectSave changes.To change the action, open the automation, select the
Add a comment to all collected recordsstep, make your changes, then selectSave changes.
Learn more
FAQs
What's the difference between Add comment and Comment on collected?
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?
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?
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?
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?
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?
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 →
