Managing Models
Each project has a Models page listing the BPMN models it contains. Open it by clicking a project on the All Projects page, or via Models in the sidebar while a project is open.
The Model List
Each model appears as a card showing its name, a preview, its lifecycle state, the current version, and when it was last modified. A model created by the AI agent carries an AI-built badge. Use the grid/list toggle to switch layouts, and the filter tabs to narrow the list:
| Filter | Shows |
|---|---|
| All | Every model in the project. |
| Draft | Models still being worked on. |
| Published | Models that have been published to the Repository. |
Creating a Model
Click New model and choose how to start - by hand or with AI. To start from a blank canvas, choose Start from scratch and click Open the editor. The AI options are covered in Creating Models with AI.
You can also click Import model to bring in an existing BPMN file (.bpmn).
Opening a Model
Click a model card to open its detail page, which has three tabs:
- Overview - a read-only preview of the model, with a summary (BPMN 2.0, element count, lifecycle state).
- Versions - the full version history (see below).
- Comments - a discussion thread where you can add comments about the model.
From the detail page, click Open in editor to edit the model, or Publish to publish it.
Model Actions
Use the options menu (the three dots) on a model card for:
| Action | What it does |
|---|---|
| Open / Open in editor | Open the model for viewing or editing. |
| Rename | Change the model's name. |
| Duplicate | Make a copy of the model in the same project. |
| Publish / Unpublish | Publish the model to the Repository, or remove it from the Repository. |
| Delete | Delete the model. Deletion cannot be undone. |
Lifecycle: Draft and Published
A new model starts as a Draft. When it is ready to share more widely, Publish it - published models appear in your organization's Repository. You can Unpublish at any time to take it back to draft.
Versions
Every save writes a new numbered version. The Versions tab on the model detail page lists every version with the date, who made the change, and a comment where available. You can download the BPMN of any earlier version. See Saving and Versions.
