The automation editor is the page where you create and change one automation. It shows the automation from top to bottom: the header, the trigger, the filter, and a list of actions. You can use the editor for many things, including:
Building a new automation and trying it with a manual run.
Changing the trigger, reordering actions, or pausing an automation.
Note:
Save your changes. New automations are saved with
Create automation. Changes to an existing automation are saved withSave changesorSave.Manual runs have real effects. Use
Simulated runto try an automation without changing data.
Who can use the editor?
Automations are available on the Free, Plus, and Premium plans. The number of automation actions per month depends on your plan. See the limits for your plan on our pricing page.
Workspace admins can create, edit, and delete automations in their workspaces.
Open the editor
To build a new automation, open the database app and click the automations icon in the top bar (tooltip
Create and view automations). The icon is only there for workspace admins, and not on mobile. Then selectNew automationat the top right or theCreate new automationcard. The same buttons are in the Automation Center →.To change an automation, open the database, click the automations icon, then select the automation. You can also select it in the Automation Center.
The header
The header is the bar at the top of the editor. From left to right it has:
Back button
←: Closes the editor. If you have unsaved changes, Tape asksDiscard changes?before you leave.Name of the automation: The name of the automation, for example
Expense approval. An icon next to it means you have unsaved changes. Hover over it to seeYou have unsaved changes.Manual runstarts a manual run. Hover over it to see the tooltipStart a manual runand the shortcutcmd/ctrl+J. Learn more in Test automations →.▷next toManual runopens the runs panel on the right. Hover over it to seeView all runs. The shortcut iscmd/ctrl+1. A dot on it means there are new runs you haven't seen.•••opens the menu with save, undo, and more. Hover over it to seeUndo, delete and more.Manual run,▷, and•••appear after you've saved the automation once.Save changessaves the automation. For a new automation, the button saysCreate automation.
The header doesn't have a button for the status or the time zone. They are in the editor itself, below and above the large title.
The title area
Below the header, the name of the automation appears again as a large title.
A new automation is called
Untitled. To rename it, select the large title and type a new name. The header only shows the name, so you rename the automation in the large title.Below the title, the status shows
ActiveorPaused. Select it to switch. A paused automation doesn't start on its trigger. Learn more in Active, paused, and broken automations →.Hover over the title to see two buttons above it:
Time zone, for exampleTime zone UTC+01:00, andAdd description.Add descriptionadds a field for a description of the automation (Add a description). SelectHide descriptionto hide it again. If the automation has a description that's hidden, the button saysShow description. The search in the Automation Center also finds automations by their description.
The Manual run button
Select Manual run to run the automation once. The run has real effects: records change, comments appear, emails go out. For triggers with a record, choose what to run on next to Run on: Selected records, Selected view (with a New badge), Number of records, or All records. With Selected records, pick records from the list. Select Start run. If you have unsaved changes, the button says Save and start run and also saves your changes. See Run an automation on existing records →.
The runs panel
Click ▷ next to Manual run (tooltip View all runs), or press cmd/ctrl + 1, to open the runs panel next to the automation. It lists every run, newest first, with its date and status. Select a run to see its steps. Learn more in Automation runs →.
At the top of the panel, Runs is the title and Follow is a button on the right. Hover over Follow to see Receive notifications for all failed runs. Select it to get a notification in Tape whenever a run of this automation fails. Follow applies only to you. The button then shows Following. To stop the notifications, hover over Following and select Unfollow. If the automation had no runs in the last 30 days, the panel says No runs for this automation during the last 30 days.
The ••• menu
The ••• menu has these items:
Savesaves your changes (cmd/ctrl+S).Undoundoes your last change in the editor (cmd/ctrl+Z).Redobrings back a change you undid (cmd/ctrl+shift+Z).Full widthis a switch that changes the width of the editor. It has no shortcut.Manual runstarts a manual run (cmd/ctrl+J).Simulated runstarts a simulated run (cmd/ctrl+K). A simulated run skips filters and doesn't change any data. Learn more in Test automations →.Cancel runsstops all scheduled and running runs of this automation. Tape asksCancel runs?first.Export runsdownloads a CSV file with the runs of this automation from the last 14 days, one row per step.Deletedeletes the automation. Tape asksDelete automation?first. A deleted automation can't be restored.At the bottom, a line shows who last changed the automation and when:
Last modified byfollowed by a name and a date.
The time zone
Every automation has its own time zone. Select Time zone above the title to open a list of time zones. At the top, a search field says Search for a time zone…. Each entry shows the offset and the place, for example UTC-08:00 and Pacific Time (US and Canada). The time zone applies to times and dates in the automation. A new automation uses your own time zone. Learn more in Dates and time zones in automations →.
The status
The status below the title shows whether the automation is Active or Paused. Select it to switch between the two, then select Save changes. If an automation is broken, the status shows Broken and you can't switch it.
The trigger
The trigger is the first card in the editor. It reads like a sentence, for example When a record is updated and Status has changed in Expenses. Each trigger has its own settings. Read Automation triggers →.
Select the app name, for example
Expenses, to open the list of apps and pick another database app. The list shows the database apps you haveFull accessto in the workspaces where you're a workspace admin. When you pick another database, the filter and the actions stay as they are. Steps that use fields of the old database are marked in red, and the automation isBrokenuntil you choose new fields.Select
▾on the left of the card to collapse it. Every card in the editor has this triangle: the trigger, the filter, and each action. Select it again to expand the card.Hover over the title to see the tooltip
Renameand the original name of the trigger. Select it to give the trigger your own name.Click the
•••of the trigger to open its menu:Turn intochanges the trigger to another one. A list opens with a search field,Search triggers…, and a check mark next to the current trigger. The list hasRecord created,Record updated,Record deleted,Comment added,Date arrives,On schedule,Automation calls,Web link clicked, andWebhook received. The database app and your actions stay. The settings of the old trigger are reset.Removeremoves the trigger. Without a trigger, the automation doesn't start. To add one again, selectAdd triggerand choose from the list (Search for a trigger…).
Some triggers change which actions you can add. For example, When a web link is clicked adds Display message and Redirect users, and When a comment is added adds Reply to comment and Delete comment. On a scheduled time or interval and When a webhook is received don't have a current record, so actions for the current record aren't in the list.
The filter
Below the trigger, And if the following conditions are met holds the filter. Select Add filter to add a condition: Where a field has a value. From the second condition on, the word in front of it is And (all must match) or Or (at least one must match). You choose it at the second condition, and it applies to all conditions on that level. Select Add filter group to nest conditions in a group of their own. The filter decides whether the actions run. On the left of a condition, ⋮⋮ moves it, and ••• on the right opens its menu with Duplicate, Turn into script filter, and Remove. The ••• of the filter card has Deactivate and Remove. Select ▾ to collapse the filter card. Learn more in Automation filters →.
Actions
Actions come after the filter. Each action is a row of its own.
Select
Add actionat the bottom to add a step. The list is grouped underBasicandAdvanced.Send API requesthas aNewbadge.BasichasCreate record,Update record,Delete record,Restore record,Add comment,Get previous values,Create PDF, andSend email, plus the actions that only some triggers add.AdvancedhasSearch for records,Get view,Get related,Get related for collected,Update related,Update collected,Comment on collected,Send email to collected,Filter collected,Sort collected,Rollup collected,Clear collected,Create web link,Call automation,Call automation on collected,Execute script,Perform calculation,Send HTTP request, andSend API request.The flow control steps
Conditional actions,Loop actions,Delay execution, andEnd runappear at the end ofAdvanced.Hover over the plus button on the left of an action. The tooltip says
Click to add an action below. Holdoption/altand click to add an action above instead. Actions inside aConditional actionsorLoop actionsblock don't have this button.Drag an action by its handle
⋮⋮to move it. You can drag an action into aConditional actionsorLoop actionsblock, and out of it again. To move an action into an empty or collapsed block, drop it on the block. You can't drop a block inside itself, and blocks can only be nested a few levels deep.Hover over an action's title to see
Renameand its original name. Select the title to rename it.Click the
•••of an action to open its menu. Under the headlineSettings, it hasAuthor,Silent,Trigger automations,Trigger webhooks,Continue on error,Deactivate,Turn into,Duplicate, andRemove. Which items you see depends on the action. Actions that change records, such asUpdate record, list their fields as rows. Each row has⋮⋮on the left to move it and•••on the right. The•••of a field row hasDuplicateandRemove, plus options that depend on the field type.Add fieldat the bottom adds another field. Select▾to collapse the action.Conditional actionsalso hasElse statement, andLoop actionsalso hasContinue statementandBreak statement. Read Action settings in automations → for what each item does.
Keyboard shortcuts
cmd/ctrl means cmd on Mac and ctrl on Windows. option/alt means option on Mac and alt on Windows.
cmd/ctrl+Ssaves the automation.cmd/ctrl+Zundoes andcmd/ctrl+shift+Zredoes.cmd/ctrl+Jstarts a manual run.cmd/ctrl+Kstarts a simulated run.cmd/ctrl+1opens the runs panel.cmd/ctrl+Bopens or closes the panel on the right, for example the runs panel. When the panel is open, the button at its top left shows the tooltipCollapse sidebar. This works once you've saved the automation.Holding
option/altwhile you click the plus button adds an action above.
Editor errors
If a step is incomplete, Tape still saves the automation, marks the title of that step in red, and sets the status to
Broken.The message
Automation could not be savedappears when saving fails for another reason. Try again.If an automation is broken, the status below the title shows
Broken. You can't switch its status or start a manual run. If you try a manual run, Tape showsTrigger runs manually not possible because of broken automation. The editor marks the title of the step that causes it, and the missing field, app, or person, in red. Choose a new one there, then selectSave changes. The status showsActiveorPausedagain once nothing is missing. Read Active, paused, and broken automations →.
Test, pause, edit, or delete an automation
Select
Manual runorSimulated runto test. Read Test automations →.Select the status below the title to turn the automation on or off, then select
Save changes.Make your changes and select
Save changes.Select
•••→Deleteto delete the automation.
Learn more
FAQs
How do I rename an automation?
How do I rename an automation?
Select the large title at the top of the editor and type a new name. A new automation is called Untitled. You can rename the trigger and every action by selecting its title.
What's the difference between Manual run and Simulated run?
What's the difference between Manual run and Simulated run?
A manual run has real effects and applies filters. A simulated run skips filters and doesn't change data. Read Test automations →.
How do I add an action above another action?
How do I add an action above another action?
Hold option/alt and click the plus button on the left of the action. A normal click adds the action below.
Can I change the trigger of an existing automation?
Can I change the trigger of an existing automation?
Yes! Click the ••• of the trigger, select Turn into, and choose another trigger.
Why can't I find an action in the list?
Why can't I find an action in the list?
Some actions depend on the trigger. On a scheduled time or interval and When a webhook is received don't have a current record, so actions for the current record aren't offered. Use Search for records or Get view first, then actions for collected records. Reply to comment and Delete comment only appear with When a comment is added, and Display message and Redirect users only with When a web link is clicked.
Still have questions? Find answers and get help from community experts in the Tape community →
