Paths

Paths let you create sequences of conditional steps inside a workflow.

You might think of a Paths as "If X is true, then do A, B & C. Else, do D and E."

Here's a quick video tutorial:

The Basics

Creating a Path group

To create a Path group, navigate to Paths in the Flow Control menu. Next, specify the rules for which Path A should be activated. By default, Path B is set to be activated for cases where no other Path is matching.

Animated demonstration of creating a path group by navigating to Paths in Flow Control menu and configuring conditional rules

Adding Paths to an existing group

To add one or more Paths to a group, click [+].

Animated demonstration of adding additional paths to an existing path group by clicking the plus button

Nesting Paths

It's possible to nest Path groups inside each other, simply by creating a new Path group inside another.

Workflow showing nested path groups with one path group containing another path group inside it

Reordering Paths

Reorder Paths by right-clicking on its header to change the order of evaluation.

Animated demonstration of reordering paths by right-clicking on the path header to access reordering options

Merging paths

In Relay.app, it's possible to continue running steps in a workflow after a path group, essentially joining or merging the paths back to one flow. This is useful if you want to use paths to conditionally execute just certain steps.

After the path, you can use data objects created, updated, or fetched within the path when:

  • The objects being created, updated, or fetched are of the same type

  • The object is being created, updated, or fetched in every path

  • If the object is a result of an AI step, all the AI outputs are named the same

For example, if you are creating a Google Contacts contact in one path and are updating a Google Contacts contact in another path, you can reference the created/updated contact in steps after the path ends.

The step output of the merged output is indicated with a path icon instead of a step number, like this:.

Workflow showing path group merging where Step 5 uses a Contact output that comes from either Step 3 or 4 depending on path taken
The contact referenced in step 5 comes out of the path group above. The contact must be either the output of step 3 or step 4, depending on which path was taken in a run.
Animated demonstration showing that merged data objects are only available when every path in a group has compatible step outputs
Merged data objects are only available when *every* path in a group has a step that creates, updates, or fetches an object of the same type.

Good to know

  • Paths are evaluated from left-to-right, and only one Path within a group will be taken. This means that if the rules of the first Path evaluate to 'true', that Path is taken. Regardless of whether rules of other Paths in the same group match as well

Last updated

Was this helpful?