--- title: "Decision" slug: "decision" updated: 2026-02-24T20:59:25Z published: 2026-02-24T20:59:25Z canonical: "docs.visualvault.com/decision" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.visualvault.com/llms.txt > Use this file to discover all available pages before exploring further. # Decision ## **Definition** --- The **Decision** action evaluates specific conditions to be true or false and determines the path a workflow should take based on those conditions. This enables workflows to respond dynamically to varying scenarios. ## **Instructions** --- To add the *Decision* action to the workflow diagram, drag and drop the action from the list on the left onto a "+" icon in the workflow diagram. ![Decision action on the workflow designer](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(305).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) ### **Properties** --- The properties of the action can be customized on the step properties panel on the right-hand side of the workflow designer. ![Decision action card and its properties panel](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(308).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) Customize the **Step Name** and **Step Description** to add readability to the workflow action within the workflow designer. The **True Label** and **False Label** can be customized to aid in readability of the workflow designer, as needed. ![Updated True and False labels](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(319).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) This action has one configuration button, *Configure*. ### **Configure** --- Click *Configure* in the properties panel to begin configurations in the Condition Builder. ![Properties panel with the Configure button highlighted](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1667458782002.png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) The **Condition Builder** allows you to configure the conditions evaluated by the *Decision* action. The conditions will be evaluated to be either TRUE or FALSE, regardless of the label used for the two branches. Click on *+ New Row* or *Add Condition* to add at least one condition to the builder. ![Condition builder](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(309).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) On the **Data Source** dropdown, select *WF Variable* or *Data View*. *Data Set Variables* are also available when the Decision action is placed inside a [Loop](/v1/docs/loop). ![Data Source selection](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(314).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) Select the **WF Variable** or **Data View** from the dropdown list. ![WF Variable selection](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(315).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) Select the **Comparison** operator. ![Comparison selection](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(320).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) On the **Compare To** dropdown, select the type of data source to compare to, either *WF Variable*, *Data View* or *Value*. ![Compare To selection](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(321).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) Select the specific *WF Variable* or *Data View* or enter the static *Value.* ![Value selection.](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(322).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) **For multiple conditions,** click on *+ New Row* to add additional lines and configure if the evaluation should use an AND or OR joining operator. ![Condition Builder highlighting Add new row and the and or joining operator](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(324).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) **To delete a condition,** check the box on the left and click *Remove Row*. ![Condition Builder highlighting remove row.](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(325).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) Once all conditions have been configured, click on **Save** to commit the changes and return to the workflow diagram. ![Save](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(326).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) The *Decision* action branches into two directions after it evaluates the condition. The last part of configuring this action is to determine what happens on each branch when the evaluation is true or false. ![Branches of the Decision action.](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image(310).png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D) > [!NOTE] > Finish > > Each branch of the Decision must end with the *Finish* action. ## **Troubleshooting** The workflow designer will prevent you from publishing a workflow when configurations are incomplete. Here are common error messages and how to address them. #### **![Publishing error message](https://cdn.document360.io/10763bcf-f13e-488f-9c3e-d6737c42ab5e/Images/Documentation/image-1771869956466.png?sv=2026-02-06&spr=https&st=2026-10-13T13%3A25%3A09Z&se=2026-10-13T14%3A25%3A09Z&sr=c&sp=r&sig=0GlpbiD2%2FY2UC75kEfPMaqmH7c5jrUvjuHnfta6OAiw%3D)** | **Message** | **Fix** | | --- | --- | | **Decision:** 'items' must not be empty. | The conditions are missing. [Configure](/v1/docs/decision#configure) the conditions for the decision. | | **Decision:** 'trueLabel' must not be empty. **Decision:** 'falseLabel' must not be empty. | The **True Label** defaults to 'true' and the **False Label** defaults to 'false'. The workflow cannot be published if either of these [properties](/v1/docs/decision#properties) is erased and left blank. | | **Diagram Error** 'Finish' is missing in at least one branch. | Ensure both branches from the *Decision* action conclude with the [Finish](/v1/docs/finish) action. |