Using Branch Block

The Branch is a workflow block for defining multiple alternative paths in one place. Instead of chaining many separate Condition blocks (hard to read and maintain), you add branches inside a single block and set rules for each. The system evaluates branches top → bottom and sends the contact down the first branch whose rules are met. This keeps complex logic clear, compact, and easy to maintain.

Why use it

• More order: Replace long Condition chains with one tidy decision point.
• Faster reviews: All rules are visible side-by-side — no more opening blocks and memorizing details.
• Easy edits: Label, duplicate, collapse, and rename branches without rebuilding logic.

Setting Up Branch Rules

1. Open or create a workflow in the Automation → Workflows section.

2. Drag the Branch block from the left sidebar into the workflow.

3. Configure branches. You can base its rules on any of the following:

• Contact field
• Start event parameter (context of the event that triggered the workflow)
• Message activity (engagement with earlier Message blocks)

📘

Note

The UI shows icons to recognize rule types quickly.

Contact Field

1. Select a contact field (e.g., favoriteCategory, sizePreference, preferredBrand).
2. Choose an operator appropriate for the field type (e.g., Equals, Does not equal, Is set, Is empty).
3. Specify the value.

Usage example

• Branch 1: favoriteCategory Equals Footwear → Sneaker drops + size-based recommendations
• Branch 2: favoriteCategory Equals Apparel → Outfit builder + new arrivals in preferred sizes
• Branch 3: favoriteCategory Equals Home → Room-by-room bundles + seasonal decor guide
• Fallback: Didn’t match 1–3 → Best-sellers + “pick your interests” prompt

📘

Tip

Combine with another field using the AND rule (e.g., favoriteCategory Equals Footwear AND sizePreference Equals 42) for higher relevance.

Start Event Parameter

1. Choose the workflow's start event parameter (e.g., utmCampaign, orderValueBucket, shippingMethod).
2. Pick an operator (e.g., Equals, Contains, Between, Is set).
3. Enter the value.

Usage example

• Branch 1: orderValueBucket Equals High → Thank-you + loyalty fast-track and premium support info trackers)
• Branch 2: orderValueBucket Equals Medium → Cross-sell essentials (care kit, add-ons)
• Branch 3: orderValueBucket Equals Low → AOV booster bundle (free shipping threshold tip)
• Fallback: Didn’t match 1–3 → Standard post-purchase series

📘

Note

The Fallback branch is evaluated after all other branches. It captures contacts that don’t match any prior rules. If you disable Fallback, contacts that don’t match any branch will stop at this point in the workflow.

Message Activity

1. Select message status: Delivered, Opened, or Clicked.
2. Select condition:

• is true → the status occurred within the chosen scope.
• is false → the status did not occur within the chosen scope.

3. Select scope:

• for the last message — checks the most recent Message block before this Branch.
• for all messages — checks across all earlier Message blocks in the workflow.

Usage example

• Branch 1: Clicked is true for the last message → Flash-sale CTA with personalized picks
• Branch 2: Delivered is false for the last message → Switch channel (SMS/push) + address validation tip
• Branch 3: Opened is false for the last message → Web push/In-app: “New arrivals just dropped — shop now”

AND / OR Rules

Inside a single branch, conditions are grouped into rule cards.

• Within one card, conditions are combined with AND rule (all must be true).
• OR rules group adds another card as an alternative set of conditions.

The branch passes if all conditions in any one card are true (Card 1 OR Card 2 OR Card 3, etc.).

Settings

1. In your branch, add the first conditions — this becomes Rule card 1 (all conditions here use AND).
2. Click OR rules group to add Rule card 2 (an alternative set).
3. Configure the conditions in Rule card 2 (again, they’re AND-ed within the card).
4. (Optional) Add more OR rules groups to create additional alternative cards.

Usage example

• Rule card 1: loyaltyLevel = VIP
• OR rule card 2: orderValueBucket Equals High

→ Action: Send “Free Express Shipping — Today Only” message

Branch Actions

Created branches (max 20) have the following management options:

• Duplicate — copy a branch with all its conditions (using the button in the block settings or selecting the branch and pressing Ctrl + D on Windows or Cmd + D on macOS).

• Rename — improve on-canvas readability with short, clear labels.

• Delete — remove an obsolete branch or rule.