Skip to main content

Automation editor

The editor is where you build an automation. Find every button, menu, and shortcut: the header, the trigger, filters, actions, the runs panel, and the status.

Written by Leo

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.

An automation in the editor with the header, a trigger, a filter, and actions

Note:

  • Save your changes. New automations are saved with Create automation. Changes to an existing automation are saved with Save changes or Save.

  • Manual runs have real effects. Use Simulated run to 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 select New automation at the top right or the Create new automation card. 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.

Opening an automation in the editor: the automations icon in the top bar of the Expenses database app opens its automations, and selecting Expense approval opens it in the editor

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 asks Discard 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 see You have unsaved changes.

  • Manual run starts a manual run. Hover over it to see the tooltip Start a manual run and the shortcut cmd/ctrl + J. Learn more in Test automations →.

  • ▷ next to Manual run opens the runs panel on the right. Hover over it to see View all runs. The shortcut is cmd/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 see Undo, delete and more.

  • Manual run, ▷, and ••• appear after you've saved the automation once.

  • Save changes saves the automation. For a new automation, the button says Create 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 Active or Paused. 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 example Time zone UTC+01:00, and Add description. Add description adds a field for a description of the automation (Add a description). Select Hide description to hide it again. If the automation has a description that's hidden, the button says Show 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 automation editor with the runs panel open on the right: Runs and Follow at the top, a failed run with its steps, and the log of the failed step Create a record

The ••• menu

The ••• menu has these items:

  • Save saves your changes (cmd/ctrl + S).

  • Undo undoes your last change in the editor (cmd/ctrl + Z).

  • Redo brings back a change you undid (cmd/ctrl + shift + Z).

  • Full width is a switch that changes the width of the editor. It has no shortcut.

  • Manual run starts a manual run (cmd/ctrl + J).

  • Simulated run starts a simulated run (cmd/ctrl + K). A simulated run skips filters and doesn't change any data. Learn more in Test automations →.

  • Cancel runs stops all scheduled and running runs of this automation. Tape asks Cancel runs? first.

  • Export runs downloads a CSV file with the runs of this automation from the last 14 days, one row per step.

  • Delete deletes the automation. Tape asks Delete automation? first. A deleted automation can't be restored.

  • At the bottom, a line shows who last changed the automation and when: Last modified by followed by a name and a date.

The ••• menu in the editor header with Save, Undo, Redo, Full width, Manual run, Simulated run, Cancel runs, Export runs, Delete, and the line Last modified by

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 have Full access to 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 is Broken until 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 Rename and 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 into changes 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 has Record created, Record updated, Record deleted, Comment added, Date arrives, On schedule, Automation calls, Web link clicked, and Webhook received. The database app and your actions stay. The settings of the old trigger are reset.

  • Remove removes the trigger. Without a trigger, the automation doesn't start. To add one again, select Add trigger and choose from the list (Search for a trigger…).

The Turn into list of a trigger with Search triggers… and all nine triggers, with a check mark next to Record updated

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.

The open action list in a new Expenses automation: the end of the basic actions with Get previous values, Create PDF, and Send email, then Advanced with Search for records and Get view
  • Select Add action at the bottom to add a step. The list is grouped under Basic and Advanced. Send API request has a New badge.

  • Basic has Create record, Update record, Delete record, Restore record, Add comment, Get previous values, Create PDF, and Send email, plus the actions that only some triggers add.

  • Advanced has Search 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, and Send API request.

  • The flow control steps Conditional actions, Loop actions, Delay execution, and End run appear at the end of Advanced.

  • Hover over the plus button on the left of an action. The tooltip says Click to add an action below. Hold option/alt and click to add an action above instead. Actions inside a Conditional actions or Loop actions block don't have this button.

  • Drag an action by its handle ⋮⋮ to move it. You can drag an action into a Conditional actions or Loop actions block, 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 Rename and its original name. Select the title to rename it.

  • Click the ••• of an action to open its menu. Under the headline Settings, it has Author, Silent, Trigger automations, Trigger webhooks, Continue on error, Deactivate, Turn into, Duplicate, and Remove. Which items you see depends on the action. Actions that change records, such as Update record, list their fields as rows. Each row has ⋮⋮ on the left to move it and ••• on the right. The ••• of a field row has Duplicate and Remove, plus options that depend on the field type. Add field at the bottom adds another field. Select ▾ to collapse the action. Conditional actions also has Else statement, and Loop actions also has Continue statement and Break 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 + S saves the automation.

  • cmd/ctrl + Z undoes and cmd/ctrl + shift + Z redoes.

  • cmd/ctrl + J starts a manual run.

  • cmd/ctrl + K starts a simulated run.

  • cmd/ctrl + 1 opens the runs panel.

  • cmd/ctrl + B opens 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 tooltip Collapse sidebar. This works once you've saved the automation.

  • Holding option/alt while 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 saved appears 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 shows Trigger 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 select Save changes. The status shows Active or Paused again once nothing is missing. Read Active, paused, and broken automations →.

Test, pause, edit, or delete an automation

  • Select Manual run or Simulated run to 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 ••• → Delete to delete the automation.

Learn more

FAQs

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?

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?

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?

Yes! Click the ••• of the trigger, select Turn into, and choose another trigger.

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 →

Did this answer your question?