Workflow error occurred
The Workflow error occurred trigger starts a workflow when workflows fail during execution.
The trigger is designed to run only once per workflow version within 30 days. For example, if a workflow fails 10 times in a day, the trigger will only run once. If the workflow is edited and fails again, the trigger will run again. If the workflow errors once in February and then again in April (more than 30 days), a second notification will be sent.
On this page
Fields
The Workflow error occurred trigger contains the following fields, which can be used in conditions and actions, and to get data in the workflow:
| Field | Description |
|---|---|
| Workflow ID | The ID of the failed workflow. |
| Workflow Run ID | The ID of the failed run. |
| Workflow Name | The name of the failed workflow. |
| Shopify Domain | The shop's .myshopify.com domain name. |
| Workflow Run URL | The URL to the failed workflow run page. |
| Workflow URL | The URL to the failed workflow summary page. |
| Workflow Version | The version of the failed workflow. |
To build a link to the workflow run, you can use the variables provided like this:
https://{{shopDomain}}/admin/apps/flow/web/overview/activity/{{workflowRunId}}
Testing the Workflow error occurred trigger
To test a notification workflow that starts with this trigger, create and trigger a test workflow that consistently encounters errors. As long as the failed workflow completes, the notification workflow should be automatically triggered. To test the notification workflow again, either create a new failing workflow or edit the existing one. After you're confident your workflow works as intended, delete your test workflow.
Actions
Any action that doesn't require data can be used with the Workflow error occurred trigger. These include:
Example
