Find Jira issues with diagrams using JQL

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

To find Jira issues with diagrams using JQL, open advanced issue search and type diagram to see the app's three fields: _diagram_count, _diagram_types and _diagram_updated, each starting with a short prefix unique to your site. For example, <prefix>_diagram_count > 0 lists every issue that has at least one diagram.

#Before you start

  • Capable Diagrams for Jira is installed and licensed.

  • Issues are indexed when someone adds or deletes a diagram on them. Issues whose diagrams were all attached before the app was installed are not found until then.

#Steps

  1. In Jira, open issue search and switch to JQL.

  2. Type diagram and pick one of the suggested fields, such as <prefix>_diagram_count. Use the suggestion rather than typing the prefix yourself.

  3. Finish the query, for example <prefix>_diagram_count > 0.

  4. Run the search, and save it as a filter if you will use it again.

Field

Example

<prefix>_diagram_count

<prefix>_diagram_count >= 2 finds issues with two or more diagrams.

<prefix>_diagram_types

<prefix>_diagram_types = mermaid finds issues with a Mermaid diagram.

<prefix>_diagram_updated

<prefix>_diagram_updated >= "2026-10-01" finds issues whose diagrams changed since that date.

#If it does not work

  • The field is not recognised: the prefix is specific to your site and environment. Pick the field from the suggestions instead of copying it from documentation. See JQL filter using the diagram fields does not resolve.

  • An issue you know has a diagram is missing: add or delete a diagram on it once so it is indexed.

Every issue with a diagram, one query away.