# Find Jira issues with diagrams using JQL

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](https://help.gocapable.com/jira-diagrams/jql-filter-using-the-diagram-fields-does-not-resolve-or-a-filter-copied-from-documentation-returns.html).
* An issue you know has a diagram is missing: add or delete a diagram on it once so it is indexed.

---

## Related

### [JQL search for issues with diagrams](https://help.gocapable.com/jira-diagrams/jql-search-for-issues-with-diagrams.html)

The three search fields.

### [Browse every diagram on a Jira site](https://help.gocapable.com/jira-diagrams/browse-every-diagram-on-a-jira-site.html)

Every diagram in one list.

### [JQL filter using the diagram fields does not resolve](https://help.gocapable.com/jira-diagrams/jql-filter-using-the-diagram-fields-does-not-resolve-or-a-filter-copied-from-documentation-returns.html)

When a filter returns nothing.

---

_Every issue with a diagram, one query away._