How to map a business process in Confluence

By Jake Marsh · Updated

To map a business process in Confluence, put the written procedure on a page and add a BPMN diagram next to it: type /bpmn, choose BPMN diagram (Lanemark), start from Blank or the Approval or Incident handling template, add a lane for each role, then draw the steps, decisions and hand-offs. Click Check to find gaps such as a branch with no label, save the version with a note, and publish. Readers can click any step for its description and linked Jira work item.

Plan the map before you draw

Answer four questions in a sentence each, above where the diagram will go:

  1. What starts it? A request, a date, a message.
  2. Who takes part? Each role becomes a lane: Requester, Manager, Finance.
  3. What are the decisions? Each becomes a gateway with a labelled branch for every answer.
  4. How does it end? Approved, rejected, cancelled. Each is an end event.

Steps

  1. Type /bpmn on the page and choose BPMN diagram (Lanemark).
  2. Start from a template if one is close, or Blank.
  3. Add a pool for the process and a lane per role, from the palette on the left.
  4. Place the start event, then a task for each piece of work, in the lane of whoever does it.
  5. Add gateways for decisions and label each outgoing flow, for example "Under $500" and "$500 or more".
  6. End every path with an end event.
  7. Describe and link steps in the right panel: a sentence on what happens, a Jira work item key for the work that tracks it, or a link to the Confluence page with the detailed instructions.
  8. Click Check and fix what it lists.
  9. Save version 1 with a name and a note, and publish the page.

What the check catches

FindingWhy it matters
No start eventReaders can't see what kicks the process off
No end event, or a flow that stops without oneA path leads nowhere
Activity without a nameA box nobody can describe
Element is not connectedA step nothing leads to
Gateway branch without a label or conditionReaders can't tell which way to go
Several flows enter an activity without a gatewayUnclear whether it waits for all of them
Gateway with one way in and one way outThe gateway does nothing
Element link is not validA Jira link that isn't a key, or a page link that isn't a page

Keep the map current

Processes change. Choose Edit above the diagram to change it without editing the page. Each save is a new version with a note, and History colors the difference between any two versions: green added, amber changed, blue moved, red removed. That makes a review meeting a matter of opening the compare view instead of reading two diagrams side by side.

To see every process in a space at once, add Process landscape (Lanemark) to a page. It lists each diagram with its page, version, last change, Jira progress (done out of linked) and check findings, and can be filtered by name, page or work item key.

When BPMN is more than you need

For a quick sketch or brainstorm, a Confluence whiteboard is faster. A BPMN map pays off when the process has roles, decisions and exceptions, when it will be reviewed and changed over time, or when it has to open in another BPMN tool later.

Lanemark starts with Atlassian's 30-day free trial; prices are on the Lanemark page. If the process already exists in Camunda or Signavio, see how to import a BPMN file into Confluence.

What it costs

Lanemark is From $11 a month for up to 10 users. Every plan and the install link are on the Lanemark page.

Lanemark: BPMN Process Modeler for Confluence

Model BPMN 2.0 processes on Confluence pages, link each step to Jira, and see exactly what changed between versions. From $11 a month for up to 10 users.


Questions

What's the difference between a pool and a lane?

A pool is one process or organisation; lanes split it by who does the work. Most internal processes need one pool with a lane per role.

Can readers edit the diagram?

Only people with edit access to the page can change it. Readers can pan, zoom and click steps.

Can I show the map in a PDF of the page?

Yes. PDF and Word exports include the diagram as an image with its name, version and date, and optionally the linked Jira work items.

How many versions are kept?

The newest 100 versions of each diagram.


More Lanemark guides


More Confluence guides