Atlassian

How to Build Branching Workflows in Confluence (With Examples)

Share:

Branching Workflows in Confluence: One Workflow, Multiple Paths

How to route documents down different paths – review, approval, publish, hold – from a single Confluence workflow, without approval-gate workarounds or cloned copies.

Every team that runs documents through Confluence eventually hits the same wall. The process in your head has forks in it – this document needs a full review, that one just needs a quick sign-off; this page goes to QA, that one publishes straight away – but the workflow you built only goes in a straight line. So you improvise. You bolt on an extra approval gate to fake a decision point. You clone the whole workflow so a handful of pages can take a different route. You keep a spreadsheet, or you just do the routing by hand and hope everyone remembers the rule.

None of that is a workflow. It’s a workaround. And workarounds are fragile: they live in one person’s memory, they break when that person is away, and they quietly stop matching how the team actually works.

What are branching workflows in Confluence?

A branching workflow is one where a single status can lead to more than one next step, and the person working the document chooses which path to take. Instead of a fixed, linear sequence – draft, review, approve, publish, in that order every time – a branching (or non-linear) workflow lets one stage offer several outgoing transitions, so you get multi-path approval from a single template.

That’s exactly what Workflows for Confluence branching does. A stage can now present multiple named paths, and the person working the document picks the right one – right from the byline. It’s a small change to the mechanics and a big change to what a workflow can honestly represent. For the first time, the workflow you build can mirror your real internal process, forks and all, instead of approximating it.

From workarounds to official, standardized workflows

Branching isn’t automation that makes decisions for you, and it isn’t about squeezing more speed out of a process. It’s about something more useful: making the paths your documents already take official.

The decision that used to live in a person’s head – “this one skips SME review because it’s a minor edit” – becomes a named branch in a workflow that everyone can see and follow. The routing that used to depend on someone remembering the rule now happens right where the work does, in the byline, with a single click. That’s the shift worth caring about: from improvised routing that only the workflow owner understands, to standardized paths the whole team can run with confidence.

Three things follow from that, and they’re the reason branching matters more than it first appears:

It’s standardized. One workflow, with its forks built in, becomes the single source of truth. You retire the cloned copies and the shadow processes. When someone new joins, the paths are in front of them, not in a colleague’s inbox.

It’s scalable. Because the branching lives inside the workflow template, you build it once and bulk-apply it across an entire space or instance. You’re not maintaining five near-identical workflows for five variations of the same process – you’re maintaining one that knows how to branch.

It’s bespoke. This is the part teams feel most. The workflow finally reflects your process – your review stages, your hold reasons, your publishing rules – rather than bending your process to fit a tool’s straight line. And because the choice happens in the byline, at the moment of work, the routing is a natural part of using the page, not a separate administrative act.

Sophisticated, flexible, tailored – but the plain-English version is simpler: your workflow can finally look like your process.

Branching workflow examples: how teams use multiple paths in Confluence

The clearest way to understand branching is to see the shapes real teams build with it. Here are four patterns we keep seeing, drawn from how teams across regulated content, life sciences, manufacturing and product documentation are already using it.

Route documents by request type in a regulated team

A compliance-minded documentation team drafts content that sometimes needs a full subject-matter-expert review and sometimes just needs a light technical check. Before branching, that meant two workflows – or a manual decision nobody could audit. 

Now a single Draft stage branches on request type: a full change goes to SME review first, a simple change skips straight to the editorial and technical audit. After the audit, a second branch handles the outcome – publish now, place on hold by reason, or send back for re-review. 

One template, several official routes, and every decision recorded in the page’s history.

Here’s how to do it:

  1. Add a Branching step named “Draft”. Connect Start ▸ Draft.
  2. Add Status “SME Review”, an Approval step “Editorial / Technical Audit”, and a Status “Rework”.
  3. From Draft, create two branches: “Full SME review” ▸ SME Review and “Simple change” ▸ Editorial / Technical Audit (skips SME).
  4. Connect SME Review ▸ Editorial / Technical Audit. On the Audit approval step, wire reject ▸ Rework and Rework ▸ Editorial / Technical Audit (the rework loop).
  5. Add a Branching step “Publish decision” after the Audit approves. Give it three branches: “Publish now” ▸ Ready to Publish, “Hold” ▸ Hold – [Reason], “Send for re-review” ▸ SME Review.
  6. Add Status “Hold – [Reason]” (clone it per hold type – Training, Project, Open Enrollment). On each, set Expire status after set time ▸ Transition to status: Initial so held pages return for review. Workflows for Confluence – Template Bank build guides · internal · July 2026 · Page 2
  7. Add Status “Ready to Publish” then “Published” (final). Connect Ready to Publish ▸ Published.
  8. On Draft, tick Restrict who can transition to the authoring group so only they start the flow.
  9. Save.

If you’re building a more detailed review process, our guide to content review and approval workflows in Confluence walks through configuring approval stages and reviewers.

Multiple transitions from a single status (signature and approval)

A senior engineer at an enterprise software team asked us a deceptively simple question: how do I get one status to lead to several different transitions? Their documents reach a “ready to sign” point and from there need to go for internal review signatures, or for internal approval, or back to draft – depending on the document. That’s the textbook case for branching. The “ready to sign” stage becomes a branch with three named exits, and the person handling the document picks the right one. 

No duplicate workflows, no gate hacks.

Here’s how it works:

  1. Add Status “Draft”. Connect Start ▸ Draft.
  2. Add a Branching step named “Ready to Sign”. Connect Draft ▸ Ready to Sign.
  3. Add Statuses “Internal Review Signatures Pending” and “Internal Approval Pending”, and a final Status “Approved”.
  4. From Ready to Sign draw three branches: “Send for review signatures” ▸ Internal Review Signatures Pending, “Send for approval” ▸ Internal Approval Pending, “Return to draft” ▸ Draft.
  5. Connect both pending statuses onward to Approved (… Pending ▸ Approved). Optionally mark “Send for approval” as the default branch.
  6. Save.

Migrating a multi-path Comala Document Management workflow

A team evaluating a move away from Comala Document Management wanted to keep a workflow where a document at draft could head down whichever path suited it – review, approval, QA, or straight to publish, with the author choosing. In a linear tool that’s impossible without cloning. With branching, Draft becomes a hub that fans out to every path, and most stages can loop back to draft for changes. It’s a natural migration target: the multi-transition behaviour Comala users rely on, rebuilt as a workflow the team owns and can bulk-apply themselves.

Follow this guide:

  1. Add a Branching step named “Draft”. This is the hub. Connect Start ▸ Draft.
  2. Add these steps: Approval “For Review”; Branching “Reviewed”; Approval “For Approval”; Status “Publish Documentation”; Approval “In QA”; Statuses “QA Passed”, “QA Failed”, and final “Published”. Workflows for Confluence – Template Bank build guides · internal · July 2026 · Page 3
  3. From the Draft hub draw five branches: For Review, For Approval, Publish Documentation, In QA, and Published (direct publish).
  4. On For Review: approve ▸ Reviewed, reject ▸ Draft.
  5. From the Reviewed branch step draw: “Send for approval” ▸ For Approval, “Publish” ▸ Publish Documentation, “Back to draft” ▸ Draft.
  6. On For Approval: approve ▸ Published, reject ▸ Draft. Connect Publish Documentation ▸ Published.
  7. On In QA: pass ▸ QA Passed ▸ Published, fail ▸ QA Failed ▸ Draft.
  8. Save.

Moving from Comala Document Management? Our migration guide explains how to recreate your workflows and map existing statuses when migrating to Workflows for Confluence.

Staged publishing with permission control

A product documentation team uses Confluence as a staging area before content syncs out to their knowledge base. Pages move through draft, technical review and final review, with visibility widening at each stage. At the publishing gate, branching lets the writer choose which permission path a page takes – locked down, or open to a specific group. And because you can restrict who fires a given transition, the team lead keeps a manager-only “send it back” path from the published state, without blocking anyone else’s normal flow.

Four teams, four very different processes – and one feature quietly making each of them official.

These are the steps:

  1. Add Statuses “Draft”, “Tech Review”, “Final Review” and connect them in sequence from Start. Use each step’s actions to set the page restrictions for that stage (writers only ▸ employees can view syncable).
  2. Add a Branching step named “Publish gate” after Final Review.
  3. Add the published end-states you need, e.g. Status “Published – Locked” and Status “Published – Marketing editable” (each carries its own page-restriction actions).
  4. From Publish gate, draw one branch per outcome: “Lock down” ▸ Published – Locked, “Allow marketing edits” ▸ Published – Marketing editable. This is where the user picks the visibility path in the byline.
  5. Make each published state a Branching step (or add branches from it) for the gatekeeper send-back: branches “Back to Draft”, “Back to Tech Review”, “Back to Final Review”.
  6. On those send-back branches set Restrict who can transition to the manager only (disable Apply restrictions to all branches so you can restrict just the send-backs). Save.

How to build a branching workflow in Confluence

We’ve turned each of these into a ready-to-use template, so you don’t have to design the pattern from scratch. Each one is built in the no-code workflow editor: You drag your stages onto the canvas, drop in a branching step wherever a stage needs to offer a choice, name each branch and save. Bulk-apply it across your space, and the process your team has been running by memory becomes something they can follow by design.

If you take one thing from this: the next time you find yourself adding an approval gate you don’t really want, or cloning a workflow to handle one exception, stop. That’s your process telling you it has a fork in it. Now you can build the fork.

 

More on managing documents in Confluence

Looking to improve more than just your workflow paths? These guides explore other ways to manage documents throughout their lifecycle:

Frequently asked questions

Can a Confluence workflow have multiple paths?

Yes. With Workflows for Confluence, a single stage can offer several outgoing transitions instead of just one. That turns a straight-line workflow into a multi-path one, where the same starting point can lead to review, approval, publishing or hold – and the person working the document chooses which path to take.

Can one status lead to several different transitions?

Yes – this is exactly what branching does. A normal status moves a document to one next step. A branching step lets that stage present several named exits at once, so a document that reaches, say, a “ready to sign” point can go for review signatures, go for approval, or return to draft. The choice is made in the page byline at the moment of work.

What is the difference between a branching workflow and a conditional workflow?

A conditional workflow routes automatically based on rules or metadata – the system decides. A branching workflow gives a person the choice: the workflow presents the available paths and someone picks the right one. Branching is deliberately manual, which is what makes it auditable – every routing decision is a recorded human choice, visible in the page’s history, rather than a hidden rule.

Who chooses which branch a document follows?

The person working the document. Each branch appears as a named option in the byline, and they select the one that fits. You can also mark one path as the default for a one-click common case, and restrict who is allowed to take a given branch – so, for example, only a team lead can send a published page back.

Can I rebuild a multi-path Comala Document Management workflow?

Yes. Teams moving from Comala Document Management often rely on a document being able to head down whichever path suits it from a single point. Branching rebuilds that behaviour: one stage becomes a hub that fans out to review, approval, QA or publish, with stages able to loop back to draft. The difference is that you build and own the workflow yourself in a no-code editor, and can bulk-apply it across a space.

Build document workflows that work your way

Not every document needs to follow the same path. With Workflows for Confluence, you can create branching workflows for reviews, approvals, QA and publishing, all tailored to how your team works.

Build the process you need, without creating separate workflows for every variation.

Try Workflows for Confluence free for 30 days

In this article:
Picture of Kelly Newcomb
Kelly Newcomb
Kelly Newcomb has spent nearly 15 years launching B2B software across technology and regulated industries. Her articles combine insights from working directly with customers and deep product expertise to help users get the most out of AppFox products.