> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conditions and branching

> Choose between If / Else, Conditional, and Optional Filters in Ravenna workflows, combine conditions with AND and OR, and merge branches into one step without it being skipped.

Workflows make decisions with three tools: **If / Else**, **Conditional**, and an action's **Optional Filters**. The difference that matters is whether each one can stop the steps after it.

## Condition steps

| Step | Result | Creates conditioned branches | Can stop downstream steps |
| - | - | - | - |
| If / Else | Is Success | Yes: True and False | Yes, through its branches |
| Conditional | Conditional > Is Success | No | No. It always completes. |
| AI Decision Maker | Is Success | Yes: True and False | Yes, through its branches |

Wait for Approval (On Approved, On Declined, On Timeout) and integration check actions such as Check Email Availability also create conditioned branches. A Conditional's result sits under its Conditional output group, not at the top level like If / Else's Is Success, so reference it there.

## Evaluation rules

* **Conditioned edges must all pass.** A step runs only if every incoming edge that carries a condition evaluates to true. Edges without a condition, shown as "Always" or unlabeled, are ignored by this check. Several If / Else True edges into one step therefore mean "all", never "any".
* **Skips cascade.** A step whose incoming conditions fail is skipped, and nothing after it runs from that path. Downstream steps run only from parents that completed or failed.
* **Failed parents.** If every immediate parent of a step failed, the step does not run. Otherwise it runs with the outputs of the parents that completed.
* **Run once.** A step that already completed in a run is not run again when another parent finishes.
* **Filter logic.** Conditions inside a group are AND. Separate groups are OR.
* **Optional Filters.** Most actions have their own filters. When they don't match, the action is skipped and its path stops, the same as a failed incoming condition.

## Recipe: run one action if any of several checks match

1. Add one Conditional per check, each with that check's conditions. Connect each to the trigger, or chain them; both work.
2. Add one action, such as Set Ticket Status, and connect every Conditional to it.
3. Give that action one filter group per Conditional, each checking that Conditional's Is Success equals true.

For "all of several checks", put every check's conditions in one group of a single If / Else or Conditional instead.

## Anti-patterns

* Several If / Else steps joined to one action to mean "any". Every conditioned edge must pass, so this means "all".
* Reading a Conditional's result at the top-level Is Success. It sits under the Conditional output group.


## Related topics

- [Workflows](https://docs.ravenna.ai/documentation/automate/workflows/overview.md)
- [Choose triggers and actions](https://docs.ravenna.ai/documentation/automate/workflows/triggers-actions.md)
- [Dynamic values](https://docs.ravenna.ai/documentation/automate/workflows/dynamic-values.md)
- [Workflow builder](https://docs.ravenna.ai/documentation/automate/workflows/workflow-builder.md)
- [Troubleshoot and retry](https://docs.ravenna.ai/documentation/automate/workflows/troubleshoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.