BPMN Master Support
A native BPMN 2.0 diagram editor for iPhone, iPad and Mac. Answers to common questions are below; if yours is not here, write to us.
- What is BPMN Master?
- How do I start a diagram?
- How do I add and connect elements?
- Where do I change an element's type?
- How do I select several elements?
- Reshaping connections and containers
- Keyboard shortcuts and the command palette
- What does the diagram check look for?
- Export, print and the XML source
- Settings and themes
- Where are my files stored?
- A file opens with a generated layout
- Will my file still open in other BPMN tools?
- System requirements
- Contact and feedback
Getting started
What is BPMN Master?
An editor for business process diagrams in BPMN 2.0, the notation published by the Object Management Group. Everything you draw is saved as a standard .bpmn file — plain XML that other BPMN tools can open. The app is written natively for Apple platforms: there is no web view inside it, and it needs no account and no internet connection.
How do I start a diagram?
Tap New diagram on the start screen on iPhone and iPad, or choose File → New on Mac. A new diagram opens with its start event already selected, so the first step is one tap away: press the “+” beside it and pick what comes next. To open an existing file, choose it in the document browser, in Files, or in Finder.
How do I add and connect elements?
The Library holds every element, drawn in real BPMN notation, with a search field on top. On Mac and iPad it is the panel on the left; on iPhone, open it with the grid button at the end of the tool dock at the bottom of the screen.
- Tap an element in the library. If exactly one element is selected, the new one is placed beside it, connected to it, and becomes the selection — so a chain is built by tapping.
- Drag an element from the library or the dock onto the canvas to put it exactly where you want. It joins the pool and lane it is dropped in, and is not connected to anything.
- Use the “+” beside a selected element for the most common next steps, or “…” for the rest of the library.
To connect two elements yourself, choose the Connect tool in the dock and drag from one to the other. The app picks the right kind of connection: a message flow between pools, an association to a text annotation, and a sequence flow otherwise.
Editing
Where do I change an element's type, markers or name?
In Properties. On Mac and iPad it is the panel on the right; on iPhone, select an element and tap the properties button in the small bar above it. There you can rename the element, change its type or trigger, set loop, multi-instance and compensation markers, mark a default flow or a condition, and write documentation. To rename, double-click or double-tap the element, or press Return.
How do I select several elements?
On Mac, Shift-click or Cmd-click to add to the selection, or drag from empty space to draw a selection rectangle; ⌘A selects everything. On iPhone and iPad there is no Shift key, so press and hold an element to add it to the selection; dragging from empty space pans the canvas instead. With several elements selected, Align and Distribute are in the “…” menu (and in the Arrange menu on Mac).
How do I reshape a connection or resize a pool?
Select a connection and it shows handles: filled circles on its bend points, hollow ones on the middle of each segment. Drag a filled one to move that bend, drag a hollow one to create a new bend, and drag a bend onto its neighbour to remove it. Points snap to a neighbour's axis, so right angles come out without careful aiming. Drag an endpoint onto another element to reconnect the flow.
Pools, lanes, groups, expanded sub-processes and annotations show handles on every corner and edge when selected. Dragging one keeps the opposite edge in place; lanes stay a tight stack, and the pool grows or shrinks to fit them.
Moving an element re-routes its connections, steering around shapes in the way. Both can be changed in Settings → Editing: turn off Re-route attached connections to keep the route you drew, and set Avoid obstacles to Never, When creating or Always.
Are there keyboard shortcuts?
Yes, on Mac and on iPad with a keyboard. ⌘K opens the command palette: one search field for every action, every element type to add and every element of the diagram to jump to. ⌘F finds elements by name, annotation text or ID.
Single letters pick tools (V select, H pan, C connect) and add elements (S start event, T task, G exclusive gateway, E end event and more). With one element selected, the new one is connected to it, so typing S T T G E sketches a whole flow. The full list is on the Keyboard page in Settings.
Where are undo and redo?
Undo is a button in the toolbar on every device, and redo is beside it or in the “…” menu, depending on how much room the toolbar has. With a keyboard, ⌘Z and ⇧⌘Z work as usual. Every edit can be undone, including the connection created together with a new element — that pair is undone in one step.
What does the diagram check look for?
The diagram is checked as you edit: start and end events with flows on the wrong side, elements no start event reaches, flows that stop without an end event, gateways that neither split nor merge, sequence flows across pools, boundary events not attached to an activity, and references to elements that do not exist.
Errors get a red badge on the canvas and warnings an amber one. The badge at the top of the canvas counts them; tap it for the list, and tap an entry to jump to the element. Badges never appear in exports or printouts. To hide them, turn off Mark problems on the canvas in Settings → Editing.
Why did my flow label move off the line?
A connection's name is placed beside its line rather than on top of it, and moves to the free side when a shape is in the way. Where a label still has to cross a line, the line is faded under the text instead of being cut, so both stay readable. Both are switches in Settings → Canvas, under Labels over lines. Label positions already written into the file are left exactly as they are.
Files and sharing
How do I export, print or see the XML?
On Mac, click the Export button (the square with an arrow) in the toolbar; on iPhone and iPad, open Export in the “…” menu. Both offer Export as PNG, Export as PDF, Print and Show XML, which shows the file exactly as it will be saved, with syntax highlighting and a Copy button. On Mac, Print is also in the File menu (⌘P). Exports and printouts always use the light paper look, whichever theme you use on screen.
Copy and paste work with standard BPMN XML, so a fragment can be pasted into another BPMN tool as text, and back again.
Where are my files stored?
Wherever you save them. BPMN Master is a standard document-based app and uses the system file browser: Files on iPhone and iPad, Finder on Mac, including iCloud Drive and any other provider you have connected. On iPhone and iPad, the app's own folder is under Browse → On My iPhone (or iPad) → BPMN Master.
On Mac, press Space on a .bpmn file in Finder to preview the diagram with Quick Look.
A file opened with a generated layout. Why?
A BPMN file can describe a process without saying where anything is drawn — the layout lives in a separate BPMNDiagram section, and some engines and scripts leave it out. BPMN Master opens such a file with a layout of its own: the flow runs left to right from the start events, and pools and lanes are stacked as bands. A note at the bottom of the canvas says the layout was generated; saving writes it into the file. Sub-processes are shown collapsed in a generated layout; their content is kept in the file.
Will my file still open in other BPMN tools?
Yes. The file is kept as a complete XML document and edited in place, never rewritten from scratch. Vendor extensions from other editors (Camunda, Zeebe, Signavio) and elements with no visual form survive a save untouched, even though this app does not display them.
Settings
Where is Settings, and what is in it?
In the “…” toolbar menu on every device; on Mac you can also press ⌘, or choose BPMN Master → Settings. It has five pages:
- General — appearance and interface language
- Canvas — dots or lines in the background, the minimap, labels over lines
- Editing — the “+” beside the selection, re-routing, avoiding obstacles, the diagram check
- Keyboard — every shortcut
- About — version, build and a link to the BPMN 2.0 specification
How do I change the theme?
In Settings → General → Appearance. Terracotta, the default, uses the colours of the app icon; Light is the bright paper look; Dark is espresso with cream lines. The change applies at once. There is no automatic option: the three themes are not a day-and-night pair, so the app keeps the one you choose.
Can I change the language?
Yes. The app is available in English, German, French, Ukrainian, Spanish, Japanese and Portuguese. By default it follows your device language, falling back to English; you can change it in Settings → General, and it applies immediately without a restart.
About the app
Does it need an internet connection?
No. The app works entirely offline, makes no network requests and collects no data. See the Privacy Policy.
System requirements
iPhone with iOS 18 or later, iPad with iPadOS 18 or later, or a Mac with macOS 15 or later.
Contact and feedback
Didn't find your answer, found a file that renders wrongly, or missing an element? Write to us — we read everything, and a sample .bpmn file attached to your message helps enormously.
Email: volodymyr.sichka@gmail.com