Finding and monitoring workflow runs

After a workflow executes, Flow provides a log of what happened, called a workflow run, that allows you to monitor its performance and behavior.

Note

Workflow runs are stored for 14 days after a run has completed. After 14 days, the run is removed from the system and is no longer available for viewing.

Where to find runs

You can monitor all workflows in the Flow app. Workflows that contain a marketing activity can also be viewed from the Admin in Marketing Automation.

View all workflow runs

You might want to view runs across all workflows if you're troubleshooting or not sure which workflow to check. To view all workflow runs, follow these steps:

1. In Flow, click Recent runs.
2. Review the runs listed and click a run to find the details.

View workflows runs for a specific workflow

2. In Flow, open the workflow.
3. Review the runs listed and click a run to find the details.

View results for a marketing automation workflow

You can view the results of a marketing automation workflow in Flow or from the Shopify admin. If you want to inspect results related to marketing, then it's best to access the results from the Shopify admin:

1. From your Shopify admin, go to Marketing > Automations.
2. Click the marketing automation that you want to monitor to view its run history.

Finding a specific workflow run

You can search for workflow runs in Flow using several methods. But before searching, consider what information you can search.

What can be searched

Before searching, consider what information you can search in the workflow run. This information is displayed inside the workflow run details and includes:

• Any IDs for resources that were used in the workflow run, such as order ID's or customer ID's
• Any text or data that was included in the workflow run, such as a tag name or product title.

In addition, when searching for a workflow run, consider the following limitations:

• The search is case-insensitive.
• The search string should not include punctuation. For example, if you're searching for an order ID, search 43843493 instead of gid://shopify/Order/43843493.
• The logs don't contain all the details about resources used in your workflow. For example, if you use a product ID in your workflow, then the workflow run log doesn't contain the product name or title unless you also used those fields.
• The search is limited to the last 14 days of workflow runs.

Search from Admin

For resources that have a More actions menu, you can initiate a workflow run search by choosing the Search Flow runs option. This option is available for the following resources:

• Orders
• Draft orders
• Customers
• Products
• Variants
• Collections

To use this option, follow these steps:

1. In the Shopify admin, open the resource that you want to search for (such as an order)
2. Click More actions.
3. Click Search Flow runs.

If you have trouble finding a run, be sure to review what can be searched.

Search from Flow

In the Flow app, you can search for any data that was included in the step data sections in a workflow run. To search, open a workflow run list and follow these steps:

1. In the recent runs list, click Add filter
2. Choose Includes text
3. Enter the text or ID to search for

If you have trouble finding a run, be sure to review what can be searched.

Search by time range

Considerations for finding a workflow run by time range:

• If the time zone on your device is different than your store's time zone, then the date and time for a workflow run might be inaccurate. Factor this difference into the Time filter that you use.
• In high volume stores, you might need to use a narrow time range and other filters to make it easier to find a specific workflow run.
• Workflow runs are stored for only 14 days after the run completes.
• There might be a delay between when a workflow runs and when its results display on the Recent runs page. If the results for a recent workflow aren't available yet, then wait a few minutes and try again.

Steps:

1. On the Recent runs page, click the Time filter in the search toolbar.
2. In the From field, enter a date and time that is equal to the time that the event should have happened. For example, for an Order created trigger, use the time that the order was created. Ensure that you enter the correct AM/PM.
3. In the To field, enter a date and time that is 10 minutes after the From date and time.
4. Review the search results. Workflows typically run at exactly the same time as a triggering event or shortly afterwards. Click a result that matches the time and verify that the displayed resource matches the resource that you're looking for, such as the order.

Viewing the recent runs list

The workflow runs table displays key data about the workflow runs:

Data included in the workflow run table

Column	Description
Run status	Running - currently executing or retrying Waiting - a wait step has delayed a workflow Completed - done
Results	List of actions completed and a list of errors by step.
Retries	If the run was retried, then a link to the list of retries is provided.
Trigger type	Manual retry - the run was a retry of a previous run Manual trigger - the workflow was run manually from the Shopify admin Trigger event - triggered by an event or a schedule

Viewing the details for a workflow run

To access detailed information about an individual workflow, click the row for the workflow run.

At the top, the Status section indicates whether the workflow was completed. The Actions section indicates how many actions in the workflow ran successfully.

The Details section displays a preview of the workflow and highlights the path(s) that the workflow took.

After the workflow preview, you can view the results, logs, and data for each step in the workflow.

For each step, you can expand the Step data section to view the data that was used in the workflow run. This data includes any IDs for resources that were used in the workflow run, such as order ID's or customer IDs, and any text or data that was included in the workflow run, such as a tag name or product title.

Workflows with For each actions

Workflows that include the For each action repeat actions several times. Flow highlights how many items followed a path in the workflow preview. Flow also displays the results from each loop iteration and allows you to filter by actions taken and errors in order to quickly troubleshoot loops.

Troubleshooting workflow runs

In some cases, a workflow run can encounter an error or not run as intended. Most commonly, this occurs when there is a configuration issue with the workflow. Learn more about troubleshooting Flow errors and retrying workflow runs to retroactively fix the result of past runs.