---
title: "State selection transitions"
canonical: "https://support.appfire.com/space/CDML/649891610/State%20selection%20transitions"
format: markdown
---
> Macro (aura-html)


# State selection transitions

> Macro (excerpt)
> 
> State selection transitions let a user choose the destination state.

These transitions are actioned by a user selecting a state in the [workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846).

![image](media://535a65df-5027-4b7c-a979-30d65296f9a9)

The state selection transition can be configured to let the user choose:

## All states

This is the default transition when a workflow editor adds a new state to a workflow, or when all transitions are removed from the state. A user can transition from the current state directly to any one of the other states. All other states in the workflow appear as destination state options in the [workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846).

![cdmdc_workflowstatedialogbox_archivestate_allstates_select_dropdownoptions.png](media://8ee3251a-8775-46be-b368-22db372e489d)

 Setting any other type of transition, including a state **select **transition, removes this default. 

<details>
<summary>All states transition workflow example</summary>

This is a workflow with four states. All states have no configured transition and default to the **All States** transition. In each workflow state, a user can transition from any state to any other state using the workflow state dialog box.

|  |  |  |
| --- | --- | --- |
| ```plaintext
{workflow:name=All states}
  {state:A}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}
``` | ![image](media://6c76f016-cbb9-4c48-aebd-40e89f9c17d6) | ![image](media://0b200f04-3407-40ed-8fe6-c9bb8cb28d91) |

In workflow builder, the **All states** transition is displayed without a named transition. 

![image](media://eb11f404-2a72-478b-972b-13a51a4f99ee)

> ℹ️ Although the destination states are listed in the transitions editor, you cannot set a destination state in the workflow builder for the **All states** transition.
> ℹ️ 
> ℹ️ - See [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923009](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923009)
</details>

## From one or more states

This is a state **select** transition. A user can transition from the current state by selecting a state in the workflow state dialog box. The available destination states can be one or more of the states in the workflow.

![cdmdc_workflowstatedialogbox_archivestate_select_fromtwostates_dropdownoptions.png](media://53128727-619b-4980-9974-07e1eb0e1570)

The choice of destination states is set by the workflow editor. The state can also include one or more of the content change transitions, **updated,** **expired**, or **task completed**. If these events occur, a change of state can occur.

 A state with a **select** transition cannot include a **submit** transition or a **content review **transition.

<details>
<summary>Select from one or more states transition workflow example</summary>

The select from one or states transition uses the `state-selection` macro. This lists the states that can be transitioned to and in what order they are displayed in the [workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846).

|  |  |  |
| --- | --- | --- |
| ```plaintext
{workflow:name=Specific state(s)}
  {state:A}
     {state-selection:states=C,B}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
  {state:D}
  {state}
{workflow}
``` | ![image](media://1fe6ebaf-f147-435e-ba01-d1547b2bd6d7) | ![image](media://e753e42d-8426-4f40-beba-5812193bde25) |

In workflow builder, you can add the state selection transition by

- Choosing **Select** as the transition type
- Select one or more options for the destination state from the dropdown menu

The order in which states are added is used to order their display in the workflow state dialog box.

A **Select** transition can be added to the state, together with

- One or more [conditions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110) for the transition to occur
- One or more additional transitions for the state

> 📝 The additional state transitions can only be **Updated**, **Expired** and **Tasks Completed**. You cannot add an approval to a state with an existing state selection transition.
</details>

## One state

This is the **submit** transition. A user can transition to the state displayed in the workflow state dialog box.

![cdmdc_workflowstatedialogbox submit_nostateoptions.png](media://83aec38c-594c-4172-a239-1f57197d39bf)

The workflow editor sets the single destination state. The state can also include one or more of the content change transitions, **updated,** **expired**, or **task completed**. If these events occur, a change of state can occur.

A state with a **submit** transition cannot include a **select **transition or a **content review **transition.

<details>
<summary>One state submit transition workflow example</summary>

The `submit` parameter limits the transition to just one state. The single option for the specified destination state appears in the [workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846).

|  |  |  |
| --- | --- | --- |
| ```plaintext
{workflow:name=One state}
  {state:A|submit=C}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}
``` | ![image](media://c15d3d9b-b4ef-48c2-be8f-fd4fefb36ce2) | ![image](media://4727529d-11e2-4977-912f-ed8bc7b62ca2) |

You can the transition using the workflow builder. In the state transitions editor:

- Choose the **Submit** transition in the state transitions editor and the single destination state
- One or more additional state transitions can be added:

The additional state transitions can be **updated**, **expired**, and **tasks Completed**.
</details>

## No state

A state can be configured so that a user has no options to manually transition from the state. When this is set, the workflow state dialog is displayed without any options to choose a destination state.

![cdmdc_workflowstatedialogbox_onlyupdatedtransition.png](media://5343a1cc-b09b-46a6-a0da-fd92701a17d1)

This occurs when the state includes one of the following:

- A user manual **select** or **submit** transition, but the workflow editor has configured the state to hide these transitions so that only a user with administrator permission can see and use them
- Only one or more of the **updated**, **expired,** or **task-completed** transitions. For example, in a workflow final state, it is good practice to only have an **updated** or **expired** transition

![cdmdc_workflowstatedialogbox_finalstate_onlyupdatedtransition.png](media://5068eb3f-a515-4dcd-b4d6-ac1b072c1b25)

<details>
<summary>No state transition workflow example</summary>

The `hideselection` parameter in a state hides the default **All states** transition or any added **submit** or **select** transition.

If the state has an added **select** or **submit** transition, only an administrator is able to view and action the transition

|  |  |  |
| --- | --- | --- |
| ```plaintext
{workflow:name=No state}
  {state:A|hideselection=true}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}
``` | ![image](media://6c350af0-6adf-4187-a275-59014b55a7a4) | ![image](media://661b87be-6b6c-4304-b9ae-0b0df8c78a93) |

If the state has the default **All states** transition

- No state destination options are shown in the [workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846)
- An administrator can use the [administrator state override](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760835) option to transition the state

In workflow builder, this **No State **option can be set by editing the state, not in the state transition editor.

In the state editor

- Check the **Advanced** option **Hide selection**

> ℹ️ You will also see the state dialog box without any transition options in a state that only has one or more of an **updated**, **expired, **and **task completed **transition.

> 📝 The **Hide selection** setting does not affect a content review transition in the state.
</details>

## Related pages

- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650120593](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650120593)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218590](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218590)