search

splitPaths

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:

hashtag
The Basics

hashtag
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

hashtag
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

hashtag
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

hashtag
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

hashtag
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:Step output pill showing path icon instead of step number to indicate merged output from path group.

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.

hashtag
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?