Graphviz Diagrams for Jira has been retired and archived on the Atlassian Marketplace on December 26, 2023. Current customers and evaluators were informed of this change on September 27, 2023.

As per our earlier communication, the maintenance of the app has been stopped as of October 15, 2023. Please contact our support team if you have any opinions.

Graphviz diagrams in Jira issue

Graphviz diagrams provide a simple and easy way to add customized diagrams into your Jira issue. As a user, you can create Graphviz diagrams dynamically either by using simple DOT language or an attachment with DOT code. You can save the diagram as an attachment, and preview, edit, or remove your diagrams based on your project requirements.

This page explains how to manage Graphviz diagrams in a Jira issue.

Create Graphviz diagram

To create a Graphviz diagram in a Jira issue:

  1. Navigate to the intended issue in which you want to create a diagram.
  2. Click Graphviz from the menu options to see the Graphviz for Jira section in the new Jira issue view.
  3. Click Graphviz from the menu options again or Add a Graphviz diagram in the Graphviz for Jira section to navigate to the Graphviz Diagrams for Jira window for further edits.
  4. Add your settings in the Graphviz Diagrams for Jira window:

    • Create diagram from: Lists the following options to create the diagram from:
      • Create a new diagram from scratch: Select this option to to generate a new diagram by entering DOT syntax in the window. 
      • Import an existing diagram from an attachment: Select this option to display a diagram based on an attachment containing DOT syntax.
    • Content (Displayed only when Create a new diagram from scratch is selected): Text area where you specify the DOT language. Enter the intended text or simple expression that defines the diagram.
      For example: Enter the following simple DOT code:

      digraph {
      	A -> B -> C;
      	B -> D;
      	D -> B [color=blue];
      }

      This results in the following output:

      For more example diagram types and DOT codes, refer to Graphviz diagram types. 

    • Graphviz source attachment (Displayed only when Import an existing diagram from an attachment is selected): Lists the files attached to the issue. Select an attachment from the available list when you want to create a diagram using the code in this specific attachment. By default, the value is set to None.
      Refer to this example for more details.
    • Layout: Lists the available diagram layouts. Select a value from the available list to render the diagram in the specified layout.
      • dot (default) - hierarchical or layered drawings for directed graphs
      • neato - spring model layouts for undirected graphs

      • twopi - radial layouts for graphs

      • circo - circular layouts for graphs

      • fdp - spring model layouts for undirected graphs
        For some example layouts, refer to Graphviz diagram layouts.
    • Graphviz output attachment name: Name of the output attachment. Enter a name to be assigned to the attachment that is the output of the DOT code specified. This attachment is attached to the issue and can be downloaded.
  5. Click the Preview () icon on the top right corner of the Content field to preview the diagram before saving the settings.

    Notice that:

    • This option is available only when Create a new diagram from scratch is selected.
    • Any errors in the specified code are listed to the right of the window as displayed in the GIF in step 4.
  6. Click Save to save the settings and navigate back to the issue to view the output diagram or click Cancel to cancel creating diagrams.

    Notice that any errors in the specified code are listed in the Graphviz for Jira section of the issue.

Step 2 and 3 refer to the new Jira issue view. In the old Jira issue view, replace step 2 and 3 with the following step:

Click Add a Graphviz diagram as shown in the following image to navigate to the Graphviz Diagrams for Jira window for further edits:


Edit or delete Graphviz diagram

To edit or delete a Graphviz diagram associated with an issue:

  1. Navigate to the intended Jira issue.
  2. In the Graphviz for Jira section of the issue, look for icons below the Graphviz diagram:

    • Click the edit () icon to edit the respective settings in the Graphviz Diagrams for Jira window.
    • Click the delete () icon delete the diagram.

For more information on Graphviz usage details, refer to Graphviz resources.


Find answers from the community.

Ask a question to the community.

Log a request with our support team.

Confluence®, Jira®, Atlassian Bamboo®, Bitbucket®, Fisheye®, and Atlassian Crucible® are registered trademarks of Atlassian®
Copyright © 2005 - 2024 Appfire | All rights reserved. Appfire™, the 'Apps for makers™' slogan and Bob Swift Atlassian Apps™ are all trademarks of Appfire Technologies, LLC.