Add and edit state transitions in workflow builder

Overview

In workflow builder, you can use the state editor in the workflow panel to edit each state and add and edit transitions.

The number of current transitions from the state is displayed.

Choose Transitions (or +Transitions button in the navigator panel) to view and edit the existing transitions or add any new transitions for the state 

Use the dropdown menus to choose:

  • the type of transition

  • the destination state for the transition

The approval transitions, Approved and Rejected are only available after an approval has been added to the state.

Only one of each type of transition is allowed from a state.

A Select transition cannot be used in the same state as an approval (Approved and/or Rejected transition)

Default transition

A new state will have the default transition that allows a user on the page to select any other state in the workflow as the destination state.

The transitions editor will display no transition type or destination state for the default 'any state' transition.

In a state with no approval added, you can add one of each of the select, updated or expired transitions.

If an approval is added to a state, you can only add one of each of the approved, rejected, updated or expired transitions.

If you add an approval to a state with an existing select transition, the workflow popup on the content will only display the approval Approve and Reject buttons.


Viewing existing transitions in workflow builder

Choose a state name in the workflow panel (or a state lozenge in the navigator panel).

This displays the state editor for the chosen state in the left-hand workflow panel.

The editor displays

  • the state name and,

  • the number of Transitions and Approvals for the state

Editing a state transition

The current state Approved in our example has a single transition. 

Choose Transitions (or +Transitions button in the navigator panel) to add new transitions or edit the existing transitions from the state. 

Use the dropdown menus to edit the type of transition and the destination state for each transition.

Choose Add to update the transitions for the state.

Transitions available to add for a state without an approval

If an approval has not been added to the state, the workflow limits the choice of transition to

  • Updated - the workflow transitions to the set destination state when the content is edited and saved

  • Expired - the workflow transitions to the set destination state when the Approved state due date is reached. A due date period must be set in the state editor

  • Select - the user chooses the destination state from one or more states using the workflow from the workflow popup. The options for the destination state are configured for the select transition by editing the state in the workflow

To add a new transition or amend an existing transition

choose the Transition (or the existing Updated) dropdown menu to select the available type of transition

  • choose the State (or for the Updated transition the existing Review state) dropdown menu to select the destination state for the transition


Choose Add to confirm any changes and update the transitions for the current state.

If you add a Select transition, add one or more destination states in the transitions editor.

The destination state for this select transition will be chosen from these states by the user using the workflow popup on the content.

Deleting a transition

To delete an existing transition highlight the transition.

Choose X to remove the transition.

Select Add to confirm the change and update the transition for the current state.

Transitions from a state with an approval added

When an approval is added to a state

  • the approved and rejected transition options become available for the state in the transitions editor

  • the select transition is not available

The Review state above, has three existing transitions

  • Updated is used to monitor any edits on the content in this state

  • Approved and Rejected transitions are components of the content review in the state

An Expired transition can be added if required.

Transitions from the Rejected state in the Basic Approval Workflow

The Rejected state in the Basic Approval Workflow has two existing transitions

  • Updated and Approved

Rejected and Expired transitions can be added to this state if required.