Skip to Content
Flower 3.7.1 is released 🎉 See what's new
DocsGet Started4 Integrate Confluence
Get Started· 3 min read· Updated November 2026

Get Started with Flower BPM for Confluence

Overview

Model in Jira, embed the diagram on a Confluence page, and Confluence always shows the latest version.

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.

A Confluence page with a BPMN diagram shown by the Flower BPMN Viewer macro

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 JiraAttached BPMN file
SourceA model from the Flower Process Repository in JiraA BPMN file attached to the Confluence page
RequiresFlower for Jira, and Flower for Confluence installed in Confluence and JiraFlower for Confluence only
DisplaysThe latest version of the modelThe 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

Setup Flower for Confluence
  1. Install Flower BPM for Confluence from the Atlassian Marketplace .
  2. 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 .
  3. To show a BPMN file instead, attach the .bpmn file to the Confluence page first.
  4. Edit the page, type / and choose the macro Flower BPMN Viewer. Its dialog opens right away.
  5. 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.
  6. 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.
Last updated on