US English (US)
ES Spanish

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
English (US)
US English (US)
ES Spanish
  • Docs home
  • Workflows
  • Building & Configuration

Multi‑path Branching in Workflows

Split a workflow into multiple branches to orchestrate different messages for different audiences

Updated at October 8th, 2025

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Home

  • Getting Started

    • Installation & Developers

      • Web Experiences

        • Mobile Experiences

          • Workflows

            • Analytics & Data

              • Account Management

                • Best Practices

                  • Integrations

                    Table of Contents

                    How it works Add a Multi‑path Branch to the Workflow canvas Randomize traffic across branches for experiments Flow behavior within branches Related references Best practices Troubleshooting FAQ

                    With Multi-path branches in Workflows, you can split a path into multiple branches to orchestrate different messages for different audiences. This lets you:

                    • Route users down distinct paths based on a segment or user property
                    • Replace complex nested true/false logic with a single, readable decision point
                    • Coordinate different sequences of Flows, emails, and push messages for each audience
                    • A/B/C test experiences by routing users into randomized branches using Audience Randomizer

                    How it works

                    When a user reaches a Multi‑path Branch node in a Workflow, the Workflow evaluates that user against the branch rules you define and routes them to the first matching branch. If no branch matches, users follow the “else” (i.e. default) path. From there, they continue to the next node(s) on that branch just like any other part of the Workflow.

                    Common use cases:

                    • Send automatic outreach depending on who an account’s CSM is
                    • Send NPS follow‑ups to detractors, neutrals, and promoters with tailored content

                    Add a Multi‑path Branch to the Workflow canvas

                     1.  Press any “+” button on the Workflow canvas, and under Logic, select “Multi-path branch”.

                    2.  Determine by what attribute you will condition your branches.

                    3.  Add branches and branch conditions. Your branch conditions will reflect on the canvas.

                    • You can condition branches based on a Segment or on a User Property
                    • Criteria for branches are evaluated from left to right on the canvas (top to bottom on the settings panel). If a user matches the conditions for more than one branch, they will only proceed on the first branch they qualify for.
                    • If no branch matches, the user moves to the default “else” path.

                    Tips ✅ 

                    • Re-order branches by dragging and dropping them in the settings panel to control priority.
                    • Keep branch conditions mutually exclusive when possible to avoid ambiguity
                    • Put more specific branches first and broader branches after

                    If you change the attribute condition of a multi-path branch node (i.e. from Segment to User Property, or vice versa), the Messages and logic on each branch will be retained, but condition values of the branches you’ve added will be cleared.

                     

                     

                    4.  Add content and/or additional branches after a branch

                    Randomize traffic across branches for experiments

                    Use the Audience Randomizer user property to create randomized branches for A/B tests. Recommended setup:

                    • One branch per variant plus a default or holdout branch
                    • Keep targeting identical across variants aside from the randomization rule
                    • Ensure total allocation across branches sums to 100% of eligible users, including “else”
                      • Ex, for an evenly split experiment with a control and 2 test variants, you would select the Audience randomizer user property and configure as follows:

                    Flow behavior within branches

                    Downstream nodes on each branch follow the same progression rules you use elsewhere:

                    • Require users to be shown a Flow before moving forward, or require completion
                    • Apply a Maximum wait so users eventually progress if they don’t see or complete the Flow

                    Related references

                    • Build a web flow in a Workflow
                    • Create Flow content in the Appcues Builder
                    • Event triggering
                    • Flow frequency (Show Once vs. Show Every Time): 
                    • Experiences frequency limit

                    Best practices

                    • Prefer multi‑path over nested true/false branches for clarity and maintainability
                    • Keep branch labels descriptive and outcome‑oriented
                    • Order branches from most specific to most general
                    • Add an explicit “else” (i.e. default) path and review it during testing
                    • Build small, modular sequences per branch for easier iteration

                    Troubleshooting

                    Users not entering the intended branch

                    • Check evaluation order and ensure the intended branch is above broader branches
                    • Confirm audience conditions are correct and available at evaluation time

                    Too many users in the default path

                    • Loosen or broaden branch conditions
                    • Add an “Uncategorized” branch with relaxed criteria before the default

                    Flows not appearing after a branch

                    • Verify Flow targeting, URL rules, and frequency settings
                    • Confirm users are logged into your app and meet trigger criteria
                    • Add a Maximum wait so users can progress if a Flow isn’t seen or completed

                    FAQ

                    Can a user match multiple branches?

                    • Branches are evaluated left-to-right. The first match is used. Reorder or refine conditions to control routing.

                    What happens if no branch matches?

                    • Users follow the default path from the branch node.

                    Can I converge paths later?

                    • Yes. You can connect multiple branches back to a shared node to continue a unified sequence.
                       

                     

                    multi-path multi-variate branch workflows

                    Was this article helpful?

                    Yes
                    No
                    Give feedback about this article

                    Related Articles

                    • Building Workflows
                    • Workflows quickstart guide
                    • Create a Workflow to welcome and follow-up with new users
                    Appcues logo

                    Product

                    Why Appcues How it works Integrations Security Pricing What's new

                    Use cases

                    Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

                    Company

                    About
                    Careers

                    Support

                    Developer Docs Contact

                    Resources

                    The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues Appcues University

                    Follow us

                    Facebook icon Twitter icon grey Linkedin icon Instagram icon
                    © 2022 Appcues. All rights reserved.
                    Security Terms of Service Privacy Policy

                    Knowledge Base Software powered by Helpjuice

                    Expand