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:
- What starts it? A request, a date, a message.
- Who takes part? Each role becomes a lane: Requester, Manager, Finance.
- What are the decisions? Each becomes a gateway with a labelled branch for every answer.
- How does it end? Approved, rejected, cancelled. Each is an end event.
Steps
- Type /bpmn on the page and choose BPMN diagram (Lanemark).
- Start from a template if one is close, or Blank.
- Add a pool for the process and a lane per role, from the palette on the left.
- Place the start event, then a task for each piece of work, in the lane of whoever does it.
- Add gateways for decisions and label each outgoing flow, for example "Under $500" and "$500 or more".
- End every path with an end event.
- 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.
- Click Check and fix what it lists.
- Save version 1 with a name and a note, and publish the page.
What the check catches
| Finding | Why it matters |
|---|---|
| No start event | Readers can't see what kicks the process off |
| No end event, or a flow that stops without one | A path leads nowhere |
| Activity without a name | A box nobody can describe |
| Element is not connected | A step nothing leads to |
| Gateway branch without a label or condition | Readers can't tell which way to go |
| Several flows enter an activity without a gateway | Unclear whether it waits for all of them |
| Gateway with one way in and one way out | The gateway does nothing |
| Element link is not valid | A 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.