Retrying workflow runs in Shopify Flow

A manual retry can help you troubleshoot your workflow and fix issues on past runs in Shopify Flow. An individual run or runs from the same workflow can be retried after issues affecting the original run(s) have been addressed.

Considerations for retrying a run

• A workflow cannot still be running or waiting (must wait until the run is successful or has errors)
• To retry a run, the associated workflow must be active. You can do this by navigating to the workflow summary page and clicking Turn on.
• The workflow trigger must match the trigger that the original run used. When a trigger is changed and no longer matches with the original run, retrying isn't possible.
• Manually retrying will use the same trigger data as the original run (For example: The ID of the resource that started the workflow).
• Manually retrying will fetch the latest data from Get data actions and use up-to-date data in conditions and actions.

Retry a run from the Run details page

1. View the details of a run by clicking the link in your workflow error notification or navigating to the run in the Flow app.
2. Troubleshoot the run and workflow. Identify which steps didn’t behave as expected and check their configuration in the workflow editor. Confirm that any admin resources used by the run have the expected attributes. Learn more about Troubleshooting Flow errors.
3. Fix the issue(s) identified in the workflow and resources.
4. Return to the run details page and choose the Retry run option and follow the prompts.
5. After a run is retried, a banner will be displayed at the top of the run details page with a link to view the retry runs.

Retry runs from the Workflow summary page

1. In the Flow app, select a workflow from the workflow list to navigate to the workflow summary page.
2. View the details of runs to determine what went wrong or had an unexpected result, confirming that all the runs that are going to be retried encountered the same issue.
3. Troubleshoot the runs and workflow. Identify which steps didn’t behave as expected and check their configuration in the workflow editor. Confirm that any admin resources used by the run have the expected attributes. Learn more about Troubleshooting Flow errors.
4. Fix the issue(s) identified in the workflow and resources.
5. In the workflow summary, select all runs impacted by the problem that will be manually retried. Then, select Retry runs from the action menu and follow the prompts.
6. Refresh the page to update the recent runs list to view the new runs. To view the retries associated with a specific run, click the View icon in the retries column.

Viewing the status of retries

From the Recent runs and Workflow summary pages

The Retries column will indicate if a run has been retried by showing an icon. Clicking the icon will filter the run list to view the original run and the retries.

The Started by column indicates whether a trigger event, manual run, or manual retry started the run.

From the Run details page

On the run details page, a banner will be displayed that includes a link to view the original run and retries in the run list.