> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Troubleshoot workflow tasks

> Learn how to troubleshoot a workflow task.

Learn how to troubleshoot a workflow task.

Zuora provides a Swimlane tool to help you diagnose the task issue and streamline the troubleshooting process. With Swimlane, you can adjust task parameters or configurations, and rerun a task instance.

On the **Tasks** tab of Workflow, click the swimlane icon  from the action menu of a Workflow task to start the Swimlane tool.

The **Swimlane** tab is then displayed. If a task fails, the error type and error message are displayed in the **Error Details** pane.

* The **API Calls** tab shows all the API calls that are performed in the task. Click an ID to view the complete request and response of the API call.
* The **Data Payload** tab provides a simplified presentation of the data payload in the API call of the current task.

Click **Task Config** to view or modify a task. The left panel shows the graphic overview of this task. To maximize this panel for easier checking, click the task overview icon  in the right-side toolbar.

If the errors are within the Liquid expression of the task, you can click the Liquid Tester icon  to test the Liquid expressions in the task. Liquid Tester is the playground where you can find potential Liquid expression errors that hinder successful workflow runs, and verify new Liquid expressions. Note that the changes are only saved to the task instance.

After you have made changes to the task, click **Rerun** to verify whether the errors are fixed. Use this button to test possible configurations.

When you have found a solution, click **Promote** to apply the updated task configuration to the task setup.

If you cannot locate the issues in your tasks, click the task properties icon  to copy all the necessary information to troubleshoot the errors. You can provide these properties when submitting a ticket at Zuora global support, and our Support team will assist you in troubleshooting.