# Multi-Split Branches

A multi-split branch sends people down different paths based on one or more conditions. People go down the first path they match.

## How it works[](#how-it-works)

A multi-split branch sends people down different paths based on one or more conditions:

*   Profile attributes
*   Segment membership
*   Events
*   [objectAn object is a non-person entity that you can associate with one or more people—like a company, account, or online course.](/journeys/objects/) attributes
*   [relationshipThe connection between an object and a person in your workspace. For instance, if you have Account objects, people could have relationships to an Account if they’re admins.](/journeys/relationships/) attributes

In this video, we show a campaign to convert people from free to paid plans, and we’ll add a multi-split branch to nudge people to download the company’s mobile app.

### What if a person could match multiple paths?[](#what-if-a-person-could-match-multiple-paths)

**A person flows down the first path they match moving from left to right (or, looking at your conditions, from top to bottom).** If they do not match any path, they will flow down the default “All others” path on the right.

[![A screenshot of the entire workspace window. Step 4 Workflow of campaign creation is selected at the top. The center of the page is the canvas of a campaign that at the top specifies the relationship attribute the campaign triggers on: role. This points down to a multi-split branch called Plan type which reads: split on trigger Account's plan_type. This points to three branches - the left branch reads: equal to legacy. The middle branch reads: equal to premium. The right most branch reads: all others. Each branch label points to a different email in the path.](https://docs.customer.io/images/branching_multi-split.png)](#661d29bb61d93eb89f8356bfb650d793-lightbox)

## Set up a multi-split branch[](#set-up-a-multi-split-branch)

By default, the multi-split branch has two, empty paths and a third “All others” path. These paths have no conditions, so they default to *false* and customers will skip them until you add conditions.

[![branching_multi-split-new.png](https://docs.customer.io/images/branching_multi-split-new.png)](#2e62c9a5cf1ffa506a4b7e65f435b153-lightbox)

1.  Drag a Multi-Split Branch into your workflow and select it to edit its conditions.
2.  Give your branch a **Name**.
3.  Choose the **Data Type** you want to use to split your audience. The options change depending on the trigger for your campaign. For example, you can only use event attributes for event-triggered campaigns, and you can only use object trigger attributes in campaigns triggered by objects or relationships.
4.  Define your paths. Add more paths if you need.
5.  Click **Save** and you’ll see the paths on your canvas update to match.

### Split based on people’s attributes[](#split-based-on-attribute-values)

To split based on the value of a single attribute, click **Attribute** in the *Data type* dropdown. Select the attribute you’d like to split on in the *Attribute name* dropdown that just appeared. And finally, enter the values of the attribute that you’d like to split on in each of the *Path* text fields. To add another path, click **Add**. Click `is equal to` if you’d like to split based on a range of values.

 Splits are evaluated from *left to right*, so make sure your conditional logic works in that order.

[![branching_multi-split-attribute-conditions-2](https://docs.customer.io/images/branching_multi-split-attribute-conditions-2.png)](#369f660f7b201fc4d580830c185f6ac6-lightbox)

Add up to 20 paths, and click **Save** to save the paths and collapse the sidebar.

### Split based on event attributes[](#split-based-on-event-attribute-values)

 You can only split based on event attributes when a campaign is triggered by an event.

To split based on the value of an event attribute, click **Event attribute** in the *Data type* dropdown. The event that triggered the campaign will appear in the group box along with a text field to specify which event attribute you would like to split on. Enter the event attribute name in the text field. Finally, enter the values of the event attribute that you’d like to split on in each of the *Path* text fields. To add another path, click **Add**. Click `is equal to` if you’d like to split based on a range of values.

 Splits are evaluated from *left to right*, so make sure your conditional logic works in that order.

[![branching_multi-split-event-conditions-3](https://docs.customer.io/images/branching_multi-split-event-conditions-3.png)](#f51665fb630f3fc0d9a0520866340716-lightbox)

Add up to 20 paths, and click **Save** to save the paths and collapse the sidebar.

### Split based on object or relationship attributes[](#split-based-on-object-or-relationship-attributes)

To split based on the value of a relationship attribute, click **Relationship** from the *Data Type* dropdown. Select the object type and attribute type. Then enter the value for each pathway. To create another path, click **Add**.

[![This shows the sidebar for a multi-split branch based on a relationship attribute. At the top, the branch name is Role. Under that, the data type of Relationship is selected. Under that, the attribute is defined as: The current person is related to the triggering object where their relationship role. Below that, the paths are split based on the relationship attribute role. Path 1 is set equal to admin. Path 2 is set equal to manager.](https://docs.customer.io/images/branch-multi-split-sidebar-4.png)](#d398b60b5a7a0ee52423ea08d17e6aad-lightbox)

 Splits are evaluated from *left to right*, so make sure your conditional logic works in that order.

For object and relationship-triggered campaigns, you can also split based on object trigger attributes. Click **Object-type-name (Trigger)** from the *Data Type* dropdown.

[![This shows the sidebar for a multi-split branch based on an object attribute. At the top, the name of the branch is Plan type. Under that, the data type of Account is selected. Under that, the attribute plan_type is specified. Below that are the paths. Path 1 is set equal to the value legacy. Path 2 is set equal to the value premium.](https://docs.customer.io/images/branch-multi-split-sidebar-2.png)](#cf051a772077dbb727b2813ddf6621e9-lightbox)

You can add up to 20 paths. Click **Save** when you’re done.

### Split based on segment membership[](#split-based-on-segment-membership)

To split based on a segment match, click **Segment** in the *Data type* dropdown. Select the segment that you’d like to split on in each *Path*. To add another path, click **Add**.

[![Multi-Split Branch segment conditions](https://docs.customer.io/images/branching_multi-split-segment-conditions.png)](#268f9fad81404ef91aff5b51a893ee71-lightbox)

Add up to 20 paths, and click **Save** to save the paths and collapse the sidebar.