Get Started with Flower BPM for Confluence
Overview
Flower BPM for Confluence (short: Flower for Confluence) embeds BPMN diagrams directly into Confluence pages.
The models themselves are created and edited in Jira with Flower for Jira. Confluence displays their latest versions.
BPMN models are created and edited in Jira, not in Confluence. Confluence is used to display them.
Jira is the better place for modeling: every model is a Jira work item, so you can find models with JQL and connect them to Jira automation and workflows.
How It Works
Add the macro Flower BPMN Viewer to a Confluence page to display a BPMN diagram. The macro can take the diagram from two sources:
| Model from Jira | Attached BPMN file | |
|---|---|---|
| Source | A model from the Flower Process Repository in Jira | A BPMN file attached to the Confluence page |
| Requires | Flower for Jira, and Flower for Confluence installed in Confluence and Jira | Flower for Confluence only |
| Displays | The latest version of the model | The attached file |
This means Flower for Confluence also works on its own. Flower for Jira is only needed if you want to embed models from the Flower Process Repository.
Use Cases
Flower for Confluence is a good fit for:
- Embedding procedural instructions as diagrams
- Displaying automation guidelines
- Documenting business process workflows without requiring Jira access
Add a BPMN Diagram to a Confluence Page
- Install Flower BPM for Confluence from the Atlassian Marketplace .
- To use models from the Flower Process Repository, make sure Flower for Jira is installed, and that Flower for Confluence is installed in Jira as well (select Jira if the installation offers it). Without it, the macro shows the hint Flower for Confluence is not installed in Jira instead of a model. In this case, write to support .
- To show a BPMN file instead, attach the
.bpmnfile to the Confluence page first. - Edit the page, type
/and choose the macro Flower BPMN Viewer. Its dialog opens right away. - In the dialog, choose the source:
- Flower process: a business process model created in Flower BPM for Jira. Pick it in the list. Only published models are shown in Confluence; an unpublished model shows The model … is not published.
- Attached BPMN file: a BPMN file attached to this page. Pick the file.
- Click Save, then publish the page. The diagram appears on the page.
To change the diagram later, edit the page, select the macro, and open its settings again. A macro without a selection shows No BPMN selected: edit the macro and select a Flower process or an attached BPMN file.
Frequently Asked Questions
How do I show a BPMN diagram in Confluence?
Install Flower BPM for Confluence, add the macro Flower BPMN Viewer to a page, and select a model from Jira or a BPMN file that is attached to the page.
Can I create or edit BPMN diagrams in Confluence?
No. With Flower, models are created and edited in Jira, and Confluence displays them. A BPMN file from any other BPMN tool can be attached to the page and displayed as well.
Do I need Flower for Jira?
Only to embed models from the Flower Process Repository. To display attached BPMN files, Flower for Confluence is enough.
Does the diagram in Confluence update when the model changes?
A model from Jira is always shown in its latest version. An attached BPMN file is shown as it was attached.
Summary
- Models are created and edited in Jira and displayed in Confluence with the macro Flower BPMN Viewer.
- Flower for Jira is optional: without it, the macro renders attached BPMN files.
- Teams keep their process documentation structured and up to date in Confluence, while Jira handles process execution and automation.

