Skip to main content

Workflow limits


Workflow limits

Yearly task usage allowances

The yearly task usage allowances vary for different editions. Currently, Zuora does not throttle workflow usage if the allowance or purchased volume is used up. 

However, if Zuora detects accidental or intentional volume growth that may lead to yearly volume abuse within a month, Zuora may throttle workflow usage.

To learn about workflow task usage allowances for different editions, see Zuora Editions

Zuora will provide always-available resources to support high-priority processing and lower in-queue wait times. For more information, see Dedicated Workflow Workers for Performance Booster Elite and Dedicated Workflow Workers for Performance Booster.

Task data payload size limit

Each workflow task can have a maximum of 5 MB data payload. If the data payload of a workflow task exceeds 5 MB, an error will occur.

You can find the payload size of a task from the Swimlane. You access the Swimlane from the menu of a task run.


You will be able to find the payload size of a task from the Tasks tab in the Data Size column.


In the Metrics tab, you will be able to find the minimum, maximum, and average task data payload sizes for recent workflow runs. If these values are close to the 5 MB limit, you can hover over the workflow to see the tasks that are the most consuming.

Task repeat times limit

When one task or several consecutive tasks keep repeating themselves without changes to the parameters being used, it enters a never-ending loop. This is a waste of resources. To avoid this scenario from happening, a limit for task repeat times is enforced.

The maximum repeat times for each task involved is 100 in the sandbox and 1000 in the production environment. Exceeding this limit will result in an error. Note that iterate flows are not counted as repeated tasks. The limit is not on the run count of a task in a workflow run, but rather the consecutive run times of a task or a section of tasks.

Alert for workflow limits

If a workflow is excessively executed nearing Zuora workflow limits, this workflow will be paused and deactivated. An email notification will be sent to all active users of your Workflow tenant in the last 30 days by default. You can overwrite this configuration to send it to a specific distribution group or users. See Enable alert notifications for details.

The thresholds for different scenarios are listed below:

  • Workflow failure percentage reaches 95%.
  • Total Workflow tasks reach 1 million in the past hour.