Branch by Value

The Branch by value actionA tool for building the processes, logic, and direction within workflows. directs your workflow to perform different actions, depending on the value of a text variable.

At the Branch by value action, the workflow splits into two or more paths, or branches. When the workflow runs, it chooses which branch to use according to the value of the variable you configure:

  • If the value exactly matches the name of a branch, the workflow chooses that branch.
  • If the value matches no branch names, it chooses the default branch.

For example, using the “Inquiry type” field of a customer contact form to decide whether to contact Sales or Support.”

You can also add as many branches as you need.

If you want to choose the branch based on a more complex condition, see Branch by condition.

To master the use of the Logic and flow actions, take the SELF: Workflow Complex Logic - Nintex Workflow Cloud course in Nintex University.

Before you start 

Configure the Branch by value action

In the Designer page: 

  1. Click the Logic and flow action group in the action toolbox.


    Find actions by browsing action groups or by typing an action name or function in the Search field at the top of the action toolbox.

  2. Drag the Branch by value action to the point where you want to create multiple paths in the workflow.
  3. Click the Branch by value action.
  4. In the Variable to evaluate field, select the variable that the workflow will use to decide which branch to take.
  5. In the Branches fields, type the value the variable must match for the workflow to choose that branch.
  6. Note: The branch names must exactly match the variable value, including case.

  7. In the Default branch field, select the branch to use if the variable does not match any branch name.
  8. Tip: create a branch and name it "Exceptions". Select it for your default branch. This branch will run when the action encounters unexpected data.

For more information on the fields and buttons, see Branch by value action fields, buttons, and settings