Skip to main content
Version: 1.3

Service tasks

A service task represents a work item in the process with a specific type.


When a service task is entered, a corresponding job is created. The process instance stops here and waits until the job is complete.

A job worker can subscribe to the job type, process the jobs, and complete them using one of the Zeebe clients. When the job is complete, the service task is completed and the process instance continues.

Task definition

A service task must have a taskDefinition; this specifies the type of job workers can subscribe to.

Optionally, a taskDefinition can specify the number of times the job is retried when a worker signals failure (default = 3).

Typically, the job type and the job retries are defined as static values (e.g. order-items) but they can also be defined as expressions (e.g. = "order-" + priorityGroup). The expressions are evaluated on activating the service task and must result in a string for the job type and a number for the retries.

Task headers

A service task can define an arbitrary number of taskHeaders; they are static metadata handed to workers along with the job. The headers can be used as configuration parameters for the worker.

Variable mappings

By default, all job variables merge into the process instance. This behavior can be customized by defining an output mapping at the service task.

Input mappings can be used to transform the variables into a format accepted by the job worker.

For more information about this topic visit the documentation about Input/output variable mappings.

Additional resources

XML representation

A service task with a custom header:

<bpmn:serviceTask id="collect-money" name="Collect Money">
<zeebe:taskDefinition type="payment-service" retries="5" />
<zeebe:header key="method" value="VISA" />

Next steps

Learn more about the concept of job types and how to set up a job worker via our manual on job workers.