Add condition groups

Condition groups let you author and manage multiple conditions in a single node. Existing condition behavior is unchanged, existing voice agent flows continue to work as before, and you can adopt condition groups only where needed. Traditional conditional authoring often required separate condition nodes for each condition. This style of conditional authoring made topic flows harder to review, troubleshoot, and maintain.

Condition groups let you manage conditions for Message nodes, Question nodes, or prompts in one place. They support both table view and graph view.

  • Manage related conditions in one place

  • Reduce branching in topic flows

  • Switch between table view and graph view for easier editing and visualization

Create a condition group

  1. Open a topic.

  2. Select Add node > Advanced > Add a condition group.

    Screenshot of the Advanced menu with Add a condition group option highlighted.

  3. After you add the node, a Condition group node appears on the canvas.

    Screenshot of a Condition group node on the canvas with edit and more options icons.

Condition group views

Use these steps to switch an existing condition group to Table view by updating the condition group ID in the code editor.

Table view

Displays conditions in a structured table and is optimized for editing multiple conditions. When in Table view mode, you can reorder the conditions using drag and drop.

Screenshot of condition group in table view with Condition, Tools, and Transition columns.

Graph view

Select View > Graph to display a branching layout similar to traditional condition nodes. Changing the view doesn't affect behavior.

Screenshot of graph view showing a condition group with Enter, Condition, and All other conditions branches.

Convert existing conditions (manual edit)

Screenshot of a condition group graph view with three Condition branches for big, small, and medium, plus an All other conditions branch.

  1. Open the topic in the code editor.

  2. Locate the condition group ID.

    Screenshot of the code editor showing a ConditionGroup with the `id` conditionGroup_HnxsWS highlighted.

  3. Append _tv to the ID, save, and close the code editor.

    Screenshot of YAML code editor with condition group ID 'conditionGroup_HnxsWS_tv' highlighted in a pink box.

    Condition grouping appears in Table view after the change.

    Screenshot of a workflow node labeled ConditionGroupSize with add buttons.

    Screenshot of ConditionGroupSize editor showing condition group node in table view with three Var1 choice conditions.