JQL filter using the diagram fields does not resolve, or a filter copied from documentation returns

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

What you are seeing

A JQL filter using the diagram fields does not resolve, or a filter copied from documentation returns an error.

#Why it happens

The JQL field names carry a 6-character prefix derived from the app id and environment, so they differ per install and per environment. A name from one environment (or from a doc) will not exist in another.

#What to do

Type the field name in the JQL editor and use the autocomplete to find the real prefix on your site, then rebuild the filter. Do not hard-code the prefix into shared documentation or boards.

#Settings involved

Setting

Where

What it does

Admin / project / site settings

-

-

Diagram (gadget configuration). Diagram

-

-

Diagram (gadget configuration). Language

-

-

#Limits that apply here

Limit

Value

What happens

Diagram title length

-

The Title input is capped at 50 characters. Titles are used verbatim as attachment filenames with no de-duplication or sanitisation, so two diagrams with the same title produce two identically named a

Browse page size

-

Each JQL page requests 12 issues and the list reveals 12 rows at a time; Show more loads the next batch. (The shared hook's own default is 50; the Diagrams page overrides it to 12.).

Concurrent diagram previews on the browse pa

-

Diagram content is downloaded one attachment at a time through a throttle, so thumbnails on a busy site fill in progressively rather than all at once.

Found it? Good.