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

# Paths

> Branch your Workflow into multiple conditional paths based on if/then rules you define.

Branch your [Workflow](/workflows/overview) into multiple paths based on conditions. Unlike [Only Continue If](/reference/actions/only-continue-if) (which stops or continues), Paths lets you route execution down different branches — each with its own set of actions.

<Steps>
  <Step title="Add the action">
    In the Workflow builder, click **+** between blocks and select **Paths** from the action library.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-3.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=d13d738056b3e60c3c298466b569e74d" alt="Action library with Paths selected" width="1042" height="550" data-path="images/reference/paths-img-3.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-4.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=6bd9f3c32c458390bbcef60195058f9c" alt="Paths action added to the Workflow" width="902" height="962" data-path="images/reference/paths-img-4.png" />
    </Frame>
  </Step>

  <Step title="Rename your paths">
    Give each path a descriptive name to clarify its purpose. This makes the Workflow easier to read and the path output easier to reference in later steps.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-6.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=5c603e68dbb3e8228b9cabca784ec459" alt="Renaming paths with descriptive names" width="994" height="560" data-path="images/reference/paths-img-6.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-7.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=ac527b6c5f98039be81f77e89ee0f187" alt="Paths with custom names applied" width="904" height="498" data-path="images/reference/paths-img-7.png" />
    </Frame>
  </Step>

  <Step title="Create conditions for each path">
    Define the conditions that determine when each path runs. Click **Add Condition** within a path tab and configure:

    1. **Field** — The variable to evaluate (from a previous step or the trigger)
    2. **Operator** — The comparison type (Equals, Contains, etc.)
    3. **Value** — The value to compare against

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-8.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=8498890b1e1c5c5464b4fb5d9eaced4e" alt="Add Condition button within a path" width="1020" height="340" data-path="images/reference/paths-img-8.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-9.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=80efb082fc6caa65173ba891434a069c" alt="Condition configured with field, operator, and value" width="902" height="1070" data-path="images/reference/paths-img-9.png" />
    </Frame>
  </Step>

  <Step title="Add And/Or operators (optional)">
    Add multiple conditions to a path by clicking the **And** or **Or** buttons:

    * **And** — Both conditions must be true for the path to run
    * **Or** — The path runs if either condition is true

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-10.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=f8abee5093736ece6de264059b98f821" alt="And/Or operator buttons for adding conditions" width="914" height="380" data-path="images/reference/paths-img-10.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-11.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=cba142192b578e7368b292b6d669d252" alt="Multiple conditions with And/Or operators" width="892" height="846" data-path="images/reference/paths-img-11.png" />
    </Frame>
  </Step>

  <Step title="Add more paths (optional)">
    Click the **+** icon next to the path tabs to add additional paths. Each path should have its own conditions.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-12.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=d97615edb1a5a1dc8c06975990df966f" alt="Adding a new path tab" width="894" height="1078" data-path="images/reference/paths-img-12.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-13.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=d498a34b0e72613a25e873937632df3b" alt="Multiple path tabs configured" width="900" height="1092" data-path="images/reference/paths-img-13.png" />
    </Frame>
  </Step>

  <Step title="Configure the last path's conditions">
    By default, the last path has **Run if no other paths are run** toggled on, making it a catch-all that executes when no other path's conditions are met. You can turn this toggle off and set specific conditions for the last path instead.

    <Warning>If you turn off the catch-all toggle, it's possible that no paths will run if none of the conditions are met.</Warning>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-14.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=01e386cdaec552b2cc4b120c55fe1a60" alt="Last path with Run if no other paths are run toggle" width="920" height="1088" data-path="images/reference/paths-img-14.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-15.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=568f40c742676d180caac64b7cb64c1d" alt="Last path with custom conditions configured" width="906" height="1214" data-path="images/reference/paths-img-15.png" />
    </Frame>
  </Step>

  <Step title="Add actions within each path">
    Click **+** inside each path to add the actions that should run when that path's condition is met. You can define a different set of actions for each path.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-16.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=43a58b16ef53aeeeeeb434dcb01d67d2" alt="Adding an action inside a path" width="950" height="432" data-path="images/reference/paths-img-16.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-17.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=1fc9b44bf1443add7ce6e865b254a292" alt="Action configured inside a path" width="958" height="1038" data-path="images/reference/paths-img-17.png" />
    </Frame>
  </Step>

  <Step title="Customize output per path (optional)">
    Toggle on **Customize Output** in each path's settings and click **Customize Output** at the bottom of the tab to define what the path returns. This is especially useful when referencing the path's output in later steps — customizing the output ensures each path produces a uniform result.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-18.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=be89fa85aa4f75639e2c6595a81a6913" alt="Customize Output toggle enabled" width="904" height="1120" data-path="images/reference/paths-img-18.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-19.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=3a0b21d2f85d5c5c60e947976baf0d00" alt="Customize Output editor for a path" width="994" height="608" data-path="images/reference/paths-img-19.png" />
    </Frame>

    <Tip>When referencing path output in subsequent steps, use **Customize Output** so each path produces a consistent format.</Tip>
  </Step>

  <Step title="Use the path output in later steps">
    Only one path runs per execution. After the Paths action, add subsequent actions and reference the path output as a single variable — it contains the output from whichever path ran.

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-20.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=23bc499c20fdfccd80cb9d216c86f8d6" alt="Action after Paths referencing the path output variable" width="3198" height="1506" data-path="images/reference/paths-img-20.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/2kKOUhntNdt3MMyN/images/reference/paths-img-21.png?fit=max&auto=format&n=2kKOUhntNdt3MMyN&q=85&s=7a72ff3580e335cc84080215867c2393" alt="Path output variable used in a subsequent action" width="3186" height="1504" data-path="images/reference/paths-img-21.png" />
    </Frame>
  </Step>
</Steps>

## Related

* [Only Continue If](/reference/actions/only-continue-if)
* [Categorize Text](/reference/actions/categorize-text)
* [Build and configure Workflows](/workflows/building)
