# Release Notes

New features and improvements in Diagrams for Jira, newest first.

## 2026

### Oct 21, 2026 (4.31.0)

* Add, view and edit comments on diagrams in Jira issues, with a resizable side panel, rich formatting and comment counts.
* Empty states for diagram collections are clearer and easier to read.
* Menus and selectors work better with screen readers and keyboards.
* Alert titles, cards and pagination now show their content correctly.
* Image placeholders and loading indicators display and clear at the right times.
* Drag-and-drop upload overlays no longer appear when nothing is being dragged.

### Oct 19, 2026 (4.30.0)

* Organise diagrams into collections in the catalogue, manage membership from menus, and search or browse their contents.
* Diagram settings now offer a Zero Egress preset where available.
* The catalogue shows diagram types as colour tags, with a wider Type column and clearer display when a type is unknown.
* Template icons now load from our hosted assets for faster, more reliable previews, with layouts unchanged.
* Saved-asset links open the right catalogue section and pinned items stay visible when off-list.
* Editing is more reliable: changes save to the right diagram version, even when switching diagrams or when version info arrives late.

### Oct 18, 2026 (4.29.0)

* Diagram types now appear as colour-coded labels in the catalogue for quicker scanning.
* D2 template icons load more reliably, including on restricted networks.

### Oct 12, 2026 (4.28.0)

* Model decision logic with DMN diagrams and decision tables.
* Simulate BPMN diagrams step by step to see how a process runs.
* Start a new diagram from the built-in template and example library, right from the diagram editor.
* Mermaid code is syntax highlighted in the code editor.

### Feb 2, 2026 (4.18.0)

* A refreshed interface aligned with the latest Atlassian Design System brings cleaner colours, typography and more familiar components.

### Jan 22, 2026 (4.17.0)

* Colour BPMN diagram components by clicking a component and choosing a colour.

## 2025

### Oct 21, 2025 (4.0.0)

* Create and edit draw.io-compatible diagrams with a drag-and-drop editor, and import diagrams.net files.
* Build BPMN diagrams visually and import existing BPMN XML, including exports from SAP Signavio.

### Sep 12, 2025 (2.6.0)

* Diagrams for Jira launches, letting you draw, embed and share diagrams without leaving Jira.
* Write diagrams in more than 20 code-based languages, including Mermaid, PlantUML and BPMN.
* Sketch and whiteboard in an Excalidraw-style visual editor.
* Insert diagrams into issues, comments and epics, and reuse diagram assets.
* Diagrams are stored in your Atlassian environment, with no third-party storage.