# Batch Triggers

Batch Triggers let you trigger multiple runs for a single workflow at once. Unlike the [Looping over a list \*inside\* a workflow](https://docs.relay.app/flow-control/iterators), Batch Triggers aren't restricted in terms of how many runs they can start.

## About Batch Triggers

You will find Batch Triggers inside the trigger menu for each app. Below the list of regular "event-based" triggers, you'll find a list of the supported Batch Triggers for that app.

In most cases, an app will have only one Batch Trigger, but some apps have multiple types of Batch Triggers.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-88b869a7348194327208759e91fc0aa9327d5c30%2FCleanShot%202025-07-18%20at%2017.22.42.png?alt=media" alt="Google Sheets has one Batch Trigger: to start runs for every row in a spreadsheet that matches your filter"><figcaption><p>Google Sheets has one Batch Trigger: to start runs for every row in a spreadsheet that matches your filter</p></figcaption></figure>

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-759cae005edc1a0b0e45025e0a7b6aee274958bc%2FCleanShot%202025-07-18%20at%2017.26.30.png?alt=media" alt="Asana has multiple Batch Triggers"><figcaption><p>Asana has multiple Batch Triggers</p></figcaption></figure>

## Setting up a Batch Trigger

### 1. Configure it to start on demand or on a recurring schedule

When selecting a Batch Trigger, you'll first need to select whether you will want to

* Manually kick off the Batch every time "on demand", or
* Start a Batch of runs on a recurring schedule (e.g. every day/month/etc) \[[more here](#id-3.-recurring-only-specify-the-schedule)]

<div align="left"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-a4f86a93d709c7ce5749d7f632f1701d768a9368%2FCleanShot%202025-07-18%20at%2017.30.43.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

### 2. Specify for which items it should start runs

First, select whether runs should be started for every item (e.g. every row in the selected spreadsheet), or only a subset. Typically you'll want to only run for a subset, and specify filters.

<div align="left"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-dd37ca3afbbe3bbf3d46497b92c7afc8da8c81a7%2FCleanShot%202025-07-18%20at%2017.35.13.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

If you've selected to only trigger runs for a subset of items, you'll need to specify filters. The "Preview" area below it will show a preview of the items that match your filters and that it would trigger runs for.

<div align="left"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-3873a4e27fba51cadb31e5d7fb7ed6be4c3bd6cf%2FCleanShot%202025-07-18%20at%2017.40.10.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

### 3a. \[Recurring only] Specify the schedule

If you've selected a Recurring Batch Trigger [above](#id-1.-configure-it-to-start-on-demand-or-on-a-recurring-schedule), specify the recurring schedule below the Preview section:

<div align="left"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-cd761dc77ab6b960d9762237f4113fd11b812d0c%2FCleanShot%202025-07-18%20at%2017.41.50.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

### 3b. Starting a Batch on demand/manually

To start a Batch manually, click 'Start batch' in the header of the Trigger. Note: this button will only appear when you have a complete workflow set up (i.e. there are steps without errors)

<div align="left"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-90f92a8070e0bac7f9b60b08f826151cd15524ec%2FCleanShot%202025-07-18%20at%2017.44.08.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
