This documentation is for WSO2 Enterprise Service Bus version 5.0.0. For the latest ESB, view the latest WSO2 Enterprise Integrator documentation.

All docs This doc
Skip to end of metadata
Go to start of metadata

The Conditional Router Mediator specifies how a message should be routed based on given conditions. The specified target sequence is applied if the condition of the mediator evaluates to true

The Conditional Router mediator is a content-aware mediator.


<conditionalRouter continueAfter="(true|false)">
    <route breakRoute="(true|false)">
      <condition ../>
      <target ../>

UI Configuration

The parameters available to configure the Conditional Router mediator are as follows.

Parameter NameDescription
Continue after Routing

This parameter specifies whether the mediation flow should/should not continue after executing the conditional router mediator. Possible values are as follows.

  • Yes/True: If this is selected, mediation continues to execute (any other mediators specified) after the conditiional router mediator.
  • No/False: If this is selected, mediation discontinues after executing the conditiional router mediator. This is the default value.
Add Route
Click this link to add a route. The conditional route will be added as a child to the Conditional Router mediator in the mediator tree as shown below.

You can add multiple conditional routes to a Conditional Router mediator by clicking on this link.

Click on the conditional route in the mediator tree to configure it. The parameters available to configure a conditional route are as follows.

Parameter NameDescription
Break after route

You can specify this for each conditional route of the conditional route mediator. It specifies whether the router should/should not continue after executing the specified conditional route.

  • Yes/True: If this is selected, a matching route would break the router, so that it does not continue to execute the next conditional route.
  • No/False: If this is selected, the router continues to execute the next conditional route defined in the conditional router mediator.
Evaluator ExpressionThe expression to evaluate the condition based on which the target mediation sequence should be applied.
Target SequenceThe mediation sequence to be applied if the expression entered in the Evaluator Expression parameter evaluates to true.


See Sample 157: Conditional Router for Routing Messages based on HTTP URL, HTTP Headers and Query Parameters for an example of the Conditional Router mediator.

  • No labels